Sorğu limitləri
Hər açarın iki limiti var: dəqiqədə və gündə sorğu sayı (gün UTC ilə hesablanır). GET /me açarınız üçün dəyərləri rateLimit sahəsində (rpm və rpd) göstərir.
Autentifikasiyalı çağırışa verilən hər cavab tükənməyə daha yaxın olan limitin vəziyyətini daşıyır - fayl yükləmələri də daxil olmaqla (onlar da sorğu limitinə hesablanır). Açar və ya limit yoxlanılmazdan əvvəl verilən cavablarda bu başlıqlar olmur: yanlış açar (401), səhv formatlı gövdə (400), naməlum yol (404), yanlış sorğu parametrləri (400 validation), çatışmayan icazə (403 forbidden_scope), test açarı üçün rədd edilmiş yazma (403).
Brauzerdə (CORS) RateLimit-*, Retry-After, Grem-Sandbox, X-Request-Id və Content-Range başlıqları oxuna bilir.
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| Başlıq | Mənası |
|---|---|
RateLimit-Limit | cari pəncərədə icazə verilən sorğular |
RateLimit-Remaining | qalan sorğular |
RateLimit-Reset | pəncərənin sıfırlanmasına qədər saniyələr |
Limit aşıldıqda title: rate_limited və Retry-After başlığı ilə 429 alırsınız. Sorğu limiti texniki qorumadır və heç vaxt ödəniş tutmur.
RateLimit-Remaining dəyərini izləyin və sorğuları zamana bölün. Tapşırıq statusunun sorğulanması pulsuz olsa da, sorğu limitinə hesablanır - bir neçə saniyədən tez-tez sorğulamayın və ya vebhuklara keçin.
Ödəniş
Ayrıca API tarifi yoxdur: çıxış abunəliyinizə daxildir, ödənişli əməliyyatlar isə kabinetdəki kimi eyni cüzdandan tutulur.
Ödənişli çağırış iki hissədən ibarətdir:
- API çağırışı. Tarifinizə daxil olan API çağırışları paketindən götürülür. Paketdən artıq çağırışlar istifadəyə görə ödənilir.
- Alətin qiyməti - əməliyyatın kabinetdəki qiyməti ilə eynidir (tarifə daxil olan kvotadan və ya cüzdandan).
Tariflər üzrə API çağırışları paketi:
| Tarif | Ayda API çağırışları |
|---|---|
| Free | 100 |
| Start | 5,000 |
| PRO | 25,000 |
| MAX | 100,000 |
| Agency Start | 50,000 |
| Agency Growth | 250,000 |
| Agency Scale | ədalətli istifadə çərçivəsində limitsiz |
Digər tariflər, alətlərin cari kvotaları və qiymətləri üçün kabinetdəki tariflər səhifəsinə baxın.
Nə ödənişlidir, nə pulsuzdur
Hər əməliyyatın ödəniş sinfi /openapi.json faylında, x-grem-billing sahəsindədir: free, api_call və ya api_call+sku:... (çağırış üstəgəl alətin qiyməti).
| Ödənişli | Pulsuz |
|---|---|
alətlərin işə salınması (qiymətləndirmə, mətnlər, video, foto, PDF, sayt və s. üçün POST) - çağırış + alətin qiyməti | bütün oxumalar (GET), o cümlədən tapşırıqların sorğulanması və fayl yükləmələri |
| flayerin və hesabat yoxlamasının təsdiqi - yalnız çağırış | obyektlər: yaratma, redaktə, silmə |
| çat mesajı - çağırış + mesajın qiyməti | lidlər və Swipe Match: yaratma, redaktə, hadisələr |
| çat sessiyalarının yaradılması, redaktəsi və silinməsi - yalnız çağırış | şəkillərin yüklənməsi |
| vebhukların idarə edilməsi |
Rədd edilmiş sorğu (4xx və ya 5xx) API çağırışı sərf etmir. İstisna vaxt aşımından sonrakı 502 provider_error cavabıdır: iş yenə də bitə və ödəniş tutula bilər - GET /works ilə yoxlayın (foto yaxşılaşdırma, sayt və qaralama üçün: kabinet və ya obyektləriniz). Ekspress qiymətləndirmənin eyni Idempotency-Key ilə təkrarı nəticəni pulsuz qaytarır (nə qiymətləndirmə, nə də API çağırışı tutulur); digər alətlərdə vaxt aşımından sonra açar 15 dəqiqə məşğul qalır - təkrarlamaq əvəzinə nəticəni yoxlayın.
Hər açar üzrə çağırışlar, xərclər və xətalar kabinetdə API səhifəsində, Analitika tabındadır.
Əlaqəli
- Xətalar -
402və429. - İdempotentlik - ikiqat ödəniş olmadan təhlükəsiz təkrarlar.