Hatalar, sayfalama ve sınırlar

Hata yanıtlarını, imleçli sayfalamayı ve istek kotalarını doğru yönetin.

Hata biçimi

{
  "success": false,
  "error": "INSUFFICIENT_SCOPE",
  "message": "API anahtarı bu işlem için gerekli kapsama sahip değil.",
  "required_scope": "servers:power",
  "request_id": "req_..."
}

Durum	Anlamı
`400`	Geçersiz parametre veya istek gövdesi
`401`	Geçersiz, süresi dolmuş ya da iptal edilmiş anahtar
`403`	Gerekli kapsam eksik
`404`	Kayıt yok veya bu hesaba ait değil
`409`	Başka işlem sürüyor ya da kaynak hazır değil
`423`	Sunucu faturalama nedeniyle askıda
`429`	İstek veya güç işlemi sınırı aşıldı
`500–503`	Geçici sunucu ya da bağımlı hizmet hatası

request_id değerini destek talebinde paylaşabilirsiniz. API anahtarını paylaşmayın.

İstek sınırları

Okuma: anahtar başına dakikada 120
Değişiklik: anahtar başına dakikada 20
Çoklu anahtarda hesap toplamı: dakikada 180 okuma ve 30 değişiklik
Güç işlemi: hesap başına dakikada 6
Aynı sunucuda güç işlemi bekleme süresi: 10 saniye
İstek gövdesi üst sınırı: 64 KB

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset ve X-RateLimit-Policy başlıklarını izleyin. 429 yanıtında Retry-After süresi dolmadan tekrar denemeyin; gecikmeye küçük rastgele sapma ekleyin.

Sayfalama

Liste uçları limit ve before kullanır. Yanıtta meta.has_more=true ise meta.next_cursor değerini değiştirmeden bir sonraki isteğe aktarın. Sayfalama sürerken yeni kayıtlar eklenebileceğinden istemci tarafında kayıt kimliğine göre tekrarları ayıklayın.

Güvenli yeniden deneme

GET istekleri ağ hatalarında üstel gecikmeyle tekrar denenebilir. Güç işlemi yanıtı kaybolursa aynı işlemi doğrudan tekrarlamak yerine önce canlı durumu okuyun. Böylece başarılı olmuş bir eylemi gereksiz yere ikinci kez çalıştırmazsınız.