Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
dev:web_api:v3:basics [2024/03/29 05:20] – [Rate Limiting] dstillmandev:web_api:v3:basics [2024/04/07 07:24] (current) – [Rate Limiting] dstillman
Line 250: Line 250:
 If the API servers are overloaded, the API may include a ''Backoff: <seconds>'' HTTP header in responses, indicating that the client should perform the minimum number of requests necessary to maintain data consistency and then refrain from making further requests for the number of seconds indicated. ''Backoff'' can be included in any response, including successful ones. If the API servers are overloaded, the API may include a ''Backoff: <seconds>'' HTTP header in responses, indicating that the client should perform the minimum number of requests necessary to maintain data consistency and then refrain from making further requests for the number of seconds indicated. ''Backoff'' can be included in any response, including successful ones.
  
-If a client has made too many requests within a given time period, the API may return ''429 Too Many Requests'' with a ''Retry-After: <seconds>'' header. Clients receiving a ''429'' should wait at least the number of seconds indicated in the header before making further requests. They should also reduce their overall request rate to avoid repeatedly getting 429s, which may result in stricter throttling or temporary blocks.+If a client has made too many requests within a given time period or is making too many concurrent requests, the API may return ''429 Too Many Requests'' with a ''Retry-After: <seconds>'' header. Clients receiving a ''429'' should wait at least the number of seconds indicated in the header before making further requests. They should also reduce their overall request rate and/or concurrency to avoid repeatedly getting 429s, which may result in stricter throttling or temporary blocks.
  
 ''Retry-After'' can also be included with ''503 Service Unavailable'' responses when the server is undergoing maintenance. ''Retry-After'' can also be included with ''503 Service Unavailable'' responses when the server is undergoing maintenance.
dev/web_api/v3/basics.1711704001.txt.gz · Last modified: 2024/03/29 05:20 by dstillman