İçeriğe geç
KuryeSoft

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

İ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:

x-ratelimit-limit
Anlamı:Dakikadaki toplam hak (600).
x-ratelimit-remaining
Anlamı:Bu dakikada kalan istek sayısı.
x-ratelimit-reset
Anlamı:Sayacın sıfırlanmasına kalan saniye.
retry-after
Anlamı: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.