Limitler ve fair use

Limitler, API’yi herkes için sağlıklı tutmak için var — normal kullanım onlara asla dokunmaz.

Rate limitler

• Public API trafiği: varsayılan olarak istemci+kullanıcı başına dakikada 60 istek.
• Ayrıca IP başına altyapı sınırları geçerlidir — normal entegrasyonlar bunlara asla ulaşmaz.
• Bir limite takılmak, Retry-After header’ıyla 429 döner; X-Rate-Limit-* header’ları her an nerede durduğunu söyler.

Fair use

Sert dakika limitlerinin ötesinde bir de yumuşak aylık kılavuz var: ayda 3.000 istek (güncel değeri canlı olarak GET /v3/users/me/usage içinden fairUse.monthlyReference olarak oku). Bu bir gösterge, bir yaptırım değil: aşmak, my.pon.app’teki kullanım sayfanda bir rengi değiştirir, başka hiçbir şey olmaz. Canlı sayıların (bugün, ay, token başına) da orada.

Kaynak kotaları

Kontrolden çıkan otomasyona karşı cömert tavanlar (details.resource ve details.limit ile 422 QUOTA_EXCEEDED):

Hata zarfı

Her hata, her endpoint, aynı biçim:

{ "errors": [ { "code": "LIST_FULL", "message": "…", "details": { "limit": 5000 } } ] }

Başarılı yanıtlar her zaman { "data": …, "meta": … } biçimindedir. Yazma yolları idempotency dostudur — başarısız bir yazmayı yeniden denemek güvenlidir.