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:

NosaukumsTipsApraksts
X-RateLimit-LimitintegerMinūtē atļautais pieprasījumu skaits.
X-RateLimit-RemainingintegerCik pieprasījumu vēl atlicis pašreizējā minūtē.
X-RateLimit-ResetintegerSekundes līdz skaitītāja atiestatīšanai.
Retry-AfterintegerTikai 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_page lī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: 42
Ierobež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."
  }
}