-
Notifications
You must be signed in to change notification settings - Fork 1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add API rate limiting to the OAS #115
Conversation
docs/VideosApi.md
Outdated
@@ -615,8 +621,9 @@ Name | Type | Description | Notes | |||
### HTTP response details | |||
| Status code | Description | Response headers | | |||
|-------------|-------------|------------------| | |||
**200** | Success | - | | |||
**200** | Success | * X-RateLimit-Limit - The request limit per minute. <br> * X-RateLimit-Remaining - The number of available requests left for the current time window. <br> * X-RateLimit-RetryAfter - The number of seconds left until the current rate limit window resets. <br> | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@szekelyzol formating is strange here
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this was autogenerated 😢
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Well it is properly displayed there: https://github.com/apivideo/api.video-java-client/blob/api-rate-limiting-oas/docs/VideosApi.md#http-response-details-6
|
||
Name | Type | Description | Notes | ||
------------ | ------------- | ------------- | ------------- | ||
**type** | **String** | A link to the error documentation. | [optional] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
just to confirm: type is just a link to the documentation?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, in API error responses type
always links to the docs
bac4753
to
295ed9e
Compare
Changes are for this Asana task.
Docs drafts are here.
Summary
429 - Too many requests
error response schema and example to every endpoint except/auth
200
response ofGET /videos
as a test: