İlk addımlar

Sorğu limitləri

Hər istifadəçi bütün açarlarının cəmində dəqiqədə 120 sorğuya qədər göndərə bilər. Sayğac saata görə hər dəqiqənin əvvəlində sıfırlanır.

Etibarlı açarla göndərilən sorğuların cavabları istifadəni bu başlıqlarda göstərir:

AdNövTəsvir
X-RateLimit-LimitintegerDəqiqədə icazə verilən sorğu sayı.
X-RateLimit-RemainingintegerCari dəqiqədə qalan sorğu sayı.
X-RateLimit-ResetintegerSayğac sıfırlanana qədər qalan saniyələr.
Retry-AfterintegerYalnız 429 cavabında: yenidən cəhd etməzdən əvvəl gözləməli olduğunuz saniyələr.

Limit aşıldıqda cavab rate_limited kodu ilə 429 olur. Yenidən cəhd etməzdən əvvəl Retry-After müddəti qədər gözləyin.

Etibarlı açar olmadan edilən cəhdlər (açarsız, səhv və ya etibarsız edilmiş açarla) hər IP ünvanı üçün dəqiqədə 30 cəhdlə məhdudlaşdırılır.

Limitə çatmamaq üçün

  • Daha az sorğu ilə daha çox element almaq üçün per_page parametrinin dəyərini artırın (ən çoxu 100).
  • TV-lərin statusunu izləmək üçün dəqiqədə bir sorğu kifayətdir.
  • Böyük tapşırıqlarda sorğuları zamana bölüşdürün və X-RateLimit-Remaining dəyərini izləyin.
Cavab başlıqları200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42
Limitə çatılıb429
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."
  }
}