diff --git a/README.md b/README.md index 55bff46..3c123cf 100644 --- a/README.md +++ b/README.md @@ -412,7 +412,25 @@ Method | HTTP request | Description - [WebhooksListResponse](https://github.com/apivideo/api.video-java-client/blob/main/docs/WebhooksListResponse.md) -### Documentation for Authorization +### Rate Limiting + +api.video implements rate limiting to ensure fair usage and stability of the service. The API provides the rate limit values in the response headers for any API requests you make. The /auth endpoint is the only route without rate limitation. + +In this client, you can access these headers by using the `*WithHttpInfo()` or `*Async` versions of the methods. These methods return the `ApiResponse` that contains the response body and the headers, allowing you to check the `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Retry-After` headers to understand your current rate limit status. +Read more about these response headers in the [API reference](https://docs.api.video/reference#limitation). + +Here is an example of how to use these methods: + +```java +ApiVideoClient client = new ApiVideoClient("YOUR_API_KEY"); +ApiResponse