Voorbeelden van HTTP API Rate Limiting HTTP Response-headers

Een van de aanvullende HTTP-statuscodes (RFC6585) is

Waar kan ik voorbeelden vinden van HTTP / REST API Rate-Limiting HTTP-responsheaders die nuttig zijn bij deze HTTP-responsstatus?


Antwoord 1, autoriteit 100%

Hier zijn enkele voorbeelden van HTTP API Rate Limiting HTTP Response-headers. Genomen uit vier veelgebruikte REST API’s: Github, Vimeo, Twitter en Imgur:

Github-snelheidsbeperking http://developer.github.com/v3/#rate-limiting

#=============================#=============================================#
# HTTP Header                 # Description                                 #
#=============================#=============================================#
| X-RateLimit-Limit           | Request limit per hour                      |
+-----------------------------+---------------------------------------------+
| X-RateLimit-Remaining       | The number of requests left for the time    |
|                             | window                                      |
+-----------------------------+---------------------------------------------+

Vimeo Rate Limiting http://developer.vimeo.com/guidelines/rate-limiting

#=============================#=============================================#
# HTTP Header                 # Description                                 #
#=============================#=============================================#
| X-RateLimit-Limit           | Request limit per day / per 5 minutes       |
+-----------------------------+---------------------------------------------+
| X-RateLimit-Remaining       | The number of requests left for the time    |
|                             | window                                      |
+-----------------------------+---------------------------------------------+
| X-RateLimit-Reset           | The remaining window before the rate limit  |
|                             | resets in UTC epoch seconds                 |
+-----------------------------+---------------------------------------------+

Twitter REST API-snelheidsbeperking https://dev.twitter.com/docs/rate -beperkend/1.1

Opmerking:Twitter gebruikt koppen met vergelijkbare namen zoals Vimeo, maar heeft een ander streepje in elke naam.

#=============================#=============================================#
# HTTP Header                 # Description                                 #
#=============================#=============================================#
| X-Rate-Limit-Limit          | The rate limit ceiling for that given       |
|                             | request                                     |
+-----------------------------+---------------------------------------------+
| X-Rate-Limit-Remaining      | The number of requests left for the         |
|                             | 15 minute window                            |
+-----------------------------+---------------------------------------------+
| X-Rate-Limit-Reset          | The remaining window before the rate limit  |
|                             | resets in UTC epoch seconds                 |
+-----------------------------+---------------------------------------------+

Imgur API-snelheidslimieten http://api.imgur.com/

#=============================#=============================================#
# HTTP Header                 # Description                                 #
#=============================#=============================================#
| X-RateLimit-UserLimit       | Total credits that can be allocated         |
+-----------------------------+---------------------------------------------+
| X-RateLimit-UserRemaining   | Total credits available                     |
+-----------------------------+---------------------------------------------+
| X-RateLimit-UserReset       | Timestamp (unix epoch) for when the credits |
|                             | will be reset                               |
+-----------------------------+---------------------------------------------+
| X-RateLimit-ClientLimit     | Total credits that can be allocated for the |
|                             | application in a day                        |
+-----------------------------+---------------------------------------------+
| X-RateLimit-ClientRemaining | Total credits remaining for the application |
|                             | in a day                                    |
+-----------------------------+---------------------------------------------+

Antwoord 2, autoriteit 24%

Vergeet naast API-specifieke headers de bescheiden, standaard Retry-Afterkop

Servers sturen het kopveld “Retry-After” om aan te geven hoe lang de
user-agent moet wachten voordat hij een vervolgverzoek doet….
De waarde van dit veld kan een HTTP-datum zijn of een aantal
seconden vertraging nadat het antwoord is ontvangen.

De standaard doet specifieke aanvullendeaanbevelingen bij gebruik met een 503- of 3xx-statuscode:

Wanneer
verzonden met een 503 (Service niet beschikbaar) antwoord, geeft Retry-After aan:
hoelang de dienst naar verwachting niet beschikbaar is voor de klant.
Wanneer verzonden met een 3xx (omleiding) antwoord, geeft Retry-After aan:
de minimale tijd dat de user-agent wordt gevraagd te wachten voordat deze wordt uitgegeven
het omgeleide verzoek.

Other episodes