Kaynaklar
Sınırlar
Sunucuyu ve diğer kullanıcıları korumak için istek sayısı ve boyutu sınırlıdır. Normal bir entegrasyon bu sınırlara yaklaşmaz.
Özet
Sınır
Değer
Not
İstek sınırı
Değer:Dakikada 600 istek
Not:İsteğin geldiği IP adresine göre sayılır; aynı IP'den gelen bütün anahtarlar bu sınırı paylaşır.
Gövde boyutu
Değer:En çok 2 MB
Not:Aşılırsa
413 BODY_TOO_LARGE.Ürün sayısı (items)
Değer:En çok 100 kalem
Not:Kalem başına en çok 30 seçenek (options), seçenek başına 200 karakter.
Paket sayısı
Değer:1–50
Not:Varsayılan 1.
Tutarlar
Değer:0 – 9.999.999 TL
Not:
total_amount, collect_amount.Hazırlık süresi
Değer:0–600 dakika
Not:
prep_minutes.Webhook yanıt süresi
Değer:8 saniye
Not:Bu sürede 2xx dönmeyen çağrı başarısız sayılır ve yeniden gönderilmez.
Takip verisi (JSON)
Değer:Dakikada 60 istek
Not:
/api/public/tracking/{token}, IP başına.İstek sınırı
API anahtarıyla yapılan istekler, geldikleri IP adresine göre sayılır: aynı sunucudan gelen bütün istekler (farklı anahtarlarla da olsa) dakikada 600 isteği paylaşır. Her yanıtta kalan hakkınız başlıklarda yazar:
Başlık
Anlamı
x-ratelimit-limitAnlamı:Dakikadaki toplam hak (600).
x-ratelimit-remainingAnlamı:Bu dakikada kalan istek sayısı.
x-ratelimit-resetAnlamı:Sayacın sıfırlanmasına kalan saniye.
retry-afterAnlamı:Yalnızca
429 yanıtında: tekrar denemeden önce beklenecek saniye.Sınır aşıldığında
HTTP/1.1 429 Too Many Requests
content-type: application/json
retry-after: 37
x-ratelimit-limit: 600
x-ratelimit-remaining: 0
{
"error": {
"code": "RATE_LIMITED",
"message": "Çok fazla istek gönderildi. Lütfen biraz bekleyin."
}
}Sınıra takılmamak için:
- Durumu sık sorgulamak yerine webhook kullanın; yedek sorguyu yalnızca açık siparişler için ve en sık 30 saniyede bir yapın.
- Ödeme tipleri ve iptal sebepleri gibi listeleri her istekte değil, günde bir kez çekip saklayın.
- Toplu aktarımda (ör. günün siparişlerini yeniden gönderme) istekleri saniyede birkaç taneyle sınırlayın.
Boyut ve alan sınırları
Gövde en çok 2 MB olabilir; aşılırsa 413 BODY_TOO_LARGE döner. Alan bazındaki uzunluk ve değer sınırları her ucun başvuru sayfasında, alanın açıklamasının altında yazar. Sınırı aşan alan 422 VALIDATION ile reddedilir; metinler sessizce kısaltılmaz.