İ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:
| Ad | Növ | Təsvir |
|---|---|---|
X-RateLimit-Limit | integer | Dəqiqədə icazə verilən sorğu sayı. |
X-RateLimit-Remaining | integer | Cari dəqiqədə qalan sorğu sayı. |
X-RateLimit-Reset | integer | Sayğac sıfırlanana qədər qalan saniyələr. |
Retry-After | integer | Yalnı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_pageparametrinin 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-Remainingdə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: 42Limitə ç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."
}
}