Darba sākšana
Pieprasījumu ierobežojumi
Katrs lietotājs var veikt līdz 120 pieprasījumiem minūtē, skaitot kopā visas savas atslēgas. Skaitītājs tiek atiestatīts katras pulksteņa minūtes sākumā.
Atbildes uz pieprasījumiem ar derīgu atslēgu rāda patēriņu šajās galvenēs:
| Nosaukums | Tips | Apraksts |
|---|---|---|
X-RateLimit-Limit | integer | Minūtē atļautais pieprasījumu skaits. |
X-RateLimit-Remaining | integer | Cik pieprasījumu vēl atlicis pašreizējā minūtē. |
X-RateLimit-Reset | integer | Sekundes līdz skaitītāja atiestatīšanai. |
Retry-After | integer | Tikai atbildē 429: sekundes, kas jānogaida pirms atkārtota mēģinājuma. |
Pārsniedzot ierobežojumu, atbilde ir 429 ar kodu rate_limited. Pirms atkārtota mēģinājuma nogaidiet Retry-After norādīto laiku.
Mēģinājumi bez derīgas atslēgas (bez atslēgas, ar nepareizu vai atsauktu atslēgu) ir ierobežoti līdz 30 mēģinājumiem minūtē katrai IP adresei.
Lai nesasniegtu ierobežojumu
- Izmantojiet
per_pagelīdz 100, lai ar mazāk pieprasījumiem iegūtu vairāk vienumu. - TV statusa uzraudzībai pietiek ar vienu pieprasījumu minūtē.
- Lieliem uzdevumiem sadaliet pieprasījumus laikā un sekojiet galvenei
X-RateLimit-Remaining.
Atbildes galvenes200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42Ierobežojums sasniegts429
HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Try again in 18 seconds."
}
}