Hatalar ve limitler
Kimlik doğrulama ve alan denetimleri işlemi başlamadan reddedebilir. Hata rehberini inceleyin; destek için request_id saklayın. Anahtar veya şifre göndermeyin.
Yanıtlar · HTTP
| HTTP | Açıklama |
|---|---|
400 / 422 | Parametre adlarını, türlerini, sınırlarını ve zorunlu değerleri kontrol edin. |
401 | Authorization başlığında geçerli güncel anahtarı kullanın. |
403 | Hesap erişimini, geçerli izinleri, doğrulamayı ve API kaynak IP listesini kontrol edin. |
404 | Kendi kayıt ID’nizi kontrol edin; başka hesabın kayıtları gösterilmez. |
409 | Yeniden denemeden önce ilgili revision/fiyatı okuyun ve ilk işlemi uzlaştırın. |
429 | Retry-After süresini bekleyip sınırlı aralıklarla sorgulayın. |
5xx / timeout | Belirsiz işlem başarısız sayılmaz. Aynı işlemi sorgulayın; yeni satın alma veya değişiklik göndermeyin. |
Hatalar ve limitler · HTTP 429
Varsayılan sınır takvim dakikası başına 60 istektir; yönetici farklı sınır belirleyebilir. capabilities.limits alanını ve HTTP 429 yanıtındaki Retry-After süresini esas alın. Anahtar yenilemek kullanımı sıfırlamaz.
Retry-After: 15
{
"ok": false,
"error": { "code": "RATE_LIMITED" },
"meta": { "request_id": "000000000000000000000429" }
}Idempotency-Key
Her değişiklik için bir Idempotency-Key üretip saklayın. Zaman aşımı veya HTTP 5xx başarısızlık kanıtı değildir. Aynı anahtarla durumunu sorgulayın; belirsizliği çözmek için yeni anahtarla yeniden işlem başlatmayın.