İstek sıklığı limitleri
Her anahtarın iki limiti vardır: dakika başına ve gün başına istek (gün UTC'ye göre sayılır). Anahtarınızın değerlerini GET /me yanıtındaki rateLimit alanı gösterir (rpm ve rpd).
Kimliği doğrulanmış bir çağrıya verilen her yanıt, tükenmeye daha yakın olan limitin durumunu taşır; dosya indirmeler de dahil (onlar da hız limitine sayılır). Anahtar veya limit kontrol edilmeden önce verilen yanıtlar bu başlıkları taşımaz: geçersiz anahtar (401), bozuk gövde (400), bilinmeyen yol (404), geçersiz sorgu parametreleri (400 validation), eksik kapsam (403 forbidden_scope), test anahtarı için reddedilen yazma (403).
Tarayıcıda (CORS) RateLimit-*, Retry-After, Grem-Sandbox, X-Request-Id ve Content-Range başlıkları okunabilir.
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| Başlık | Anlamı |
|---|---|
RateLimit-Limit | mevcut pencerede izin verilen istek sayısı |
RateLimit-Remaining | kalan istek sayısı |
RateLimit-Reset | pencerenin sıfırlanmasına kalan saniye |
Limitin üzerinde title: rate_limited ve Retry-After başlığıyla 429 gelir. İstek sıklığı limiti teknik bir korumadır ve hiçbir zaman ücret almaz.
RateLimit-Remaining değerini izleyin ve istekleri zamana yayın. İş durumu sorgulama da ücretsiz olmasına rağmen limite dahildir: birkaç saniyeden sık sorgulamayın veya webhook'lara geçin.
Ücretlendirme
Ayrı bir API planı yoktur: erişim aboneliğinizin bir parçasıdır, ücretli işlemler paneldekiyle aynı cüzdandan düşülür.
Ücretli bir çağrının iki kısmı vardır:
- API çağrısı. Plana dahil çağrı hacminden. Bunun üzerinde çağrılar kullanıma göre ücretlendirilir.
- Araç ücreti: aynı işlemin paneldeki fiyatı kadar (dahil hacimden veya cüzdandan).
Plana göre API çağrı hacmi:
| Plan | Aylık API çağrısı |
|---|---|
| Free | 100 |
| Start | 5.000 |
| PRO | 25.000 |
| MAX | 100.000 |
| Agency Start | 50.000 |
| Agency Growth | 250.000 |
| Agency Scale | makul kullanım dahilinde sınırsız |
Diğer planlar ile araçların güncel hacim ve fiyatları paneldeki planlar sayfasındadır.
Neler ücretli, neler değil
Her işlemin ücretlendirme sınıfı /openapi.json içinde, x-grem-billing alanındadır: free, api_call veya api_call+sku:... (çağrı artı araç ücreti).
| Ücretli | Ücretsiz |
|---|---|
Araç başlatma (değerleme, metin, video, fotoğraf, PDF, site vb. için POST): çağrı + araç ücreti | tüm okumalar (GET), iş sorgulamaları ve indirmeler dahil |
| Broşür ve rapor incelemesi onayı: yalnızca çağrı | İlanlar: oluşturma, düzenleme, silme |
| Sohbet mesajı: çağrı + mesaj ücreti | Lead'ler ve Swipe Match: oluşturma, düzenleme, olaylar |
| Sohbet oturumu oluşturma, düzenleme ve silme: yalnızca çağrı | Görsel yükleme |
| Webhook yönetimi |
Reddedilen bir istek (4xx veya 5xx) API çağrısı harcamaz. İstisna, zaman aşımından sonraki 502 provider_error yanıtıdır: iş yine de bitip ücretlendirilebilir; GET /works ile kontrol edin (fotoğraf iyileştirme, site ve taslak: panelde veya ilanlarınız arasında). Hızlı değerlemeyi aynı Idempotency-Key ile tekrarlamak sonucu ücretsiz döndürür (ne değerleme ne API çağrısı); diğer araçlarda zaman aşımından sonra anahtar 15 dakika dolu kalır - tekrarlamak yerine sonucu kontrol edin.
Anahtar başına çağrılar, harcamalar ve hatalar panelde, API sayfasının Analitik sekmesinde görülür.
İlgili makaleler
- Hatalar:
402ve429. - İdempotans: çift ücret olmadan güvenli tekrarlar.