Hatalar

Tek hata biçimi, HTTP durum kodları ve hata kodlarının listesi.

Bütün hatalar aynı JSON gövdesiyle döner. code makine için sabittir; message insan için açıklamadır ve değişebilir, programınızı ona göre yazmayın.

json

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "..."
  }
}

Hata kodları

Kod	HTTP	Anlamı
`INVALID_INPUT`	400	İstek gövdesi ya da parametre geçersiz.
`TOKEN_INVALID`	401	Anahtar biçimi yanlış ya da böyle bir anahtar yok.
`TOKEN_REVOKED`	401	Anahtar iptal edilmiş.
`TOKEN_EXPIRED`	401	Anahtarın süresi dolmuş.
`TOKEN_SCOPE`	403	Salt okunur anahtarla yazma ya da anahtarın ürün listesinde olmayan bir yol.
`TOKEN_FORBIDDEN`	403	Bu işlem anahtarla yapılamaz (anahtar, ekip, davet); panelden yapın.
`READ_ONLY_ROLE`	403	Hesaptaki rolünüz salt okunur.
`FORBIDDEN`	403	Rolünüz bu işlem için yetmiyor.
`NOT_FOUND`	404	Kayıt ya da uç bulunamadı.
`LIMIT_REACHED`	409	Bir sınıra ulaşıldı (ör. 25 etkin anahtar).
`RATE_LIMITED`	429	Dakikalık istek sınırı aşıldı; `Retry-After` kadar bekleyin.
`SERVER_ERROR`	500	Beklenmeyen hata; tekrarlıyorsa destek ekibine yazın.
`UPSTREAM_UNAVAILABLE`	503	Bağlı bir servise geçici olarak ulaşılamıyor; `Retry-After` sonra yeniden deneyin.
`SERVICE_UNAVAILABLE`	503	Servis şu anda kullanılamıyor.

Bazı uçlar kendi işine özgü başka kodlar da döndürebilir (ör. sipariş ve ödeme). Bilinmeyen bir kodu HTTP durumuna göre ele alın: 4xx isteği düzeltin, 5xx ve 429'da bekleyip yeniden deneyin.

Kesinti şüphesi varsa önce sistem durumu sayfasına bakın.