Başlarken

Hatalar

Bir sorun oluştuğunda API, ilgili HTTP durum koduyla ve error içinde code ile message bulunan bir gövdeyle yanıt verir.

Programınızda code değerini kullanın. message, hata ayıklayan kişiye yardımcı olmak için yazılmış İngilizce bir metindir ve değişebilir.

Hata biçimi404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}

Anahtar yok401

{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Hata kodları

Durum	Kod	Ne zaman oluşur
400	`key_in_query`	Anahtar URL'de gönderildi (`api_key`, `apikey`, `key` veya `token` parametreleri). Anahtarı başlıkta gönderin ve yeni bir anahtar oluşturun; önceki anahtar günlüklere kaydedilmiş olabilir.
400	`invalid_parameter`	Bir parametrenin değeri geçersiz, ör. `per_page` izin verilen en yüksek değerin üzerinde.
401	`missing_api_key`	İstekte anahtar yok.
401	`invalid_api_key`	Anahtar mevcut değil, geçersiz kılınmış veya anahtarın kullanıcısı devre dışı bırakılmış.
404	`not_found`	Uç nokta mevcut değil ya da öğe mevcut değil veya kullanıcının göremediği bir kuruluşa ait.
404	`organization_not_found`	Belirtilen `organization`, kullanıcının bu tür öğeleri görebildiği bir kuruluşa ait değil.
405	`method_not_allowed`	API yalnızca `GET` (ve `HEAD`) isteklerini kabul eder.
429	`rate_limited`	İstek limitine ulaşıldı. `Retry-After` içinde belirtilen saniye kadar bekleyin.
500	`server_error`	Dahili hata. Birazdan tekrar deneyin; sorun devam ederse destek ekibiyle iletişime geçin.

Ne zaman tekrar denenmeli

Aynı isteği yalnızca 429 (Retry-After süresini bekledikten sonra) veya 500 hatasından sonra tekrarlayın. Diğer hatalar istekte ya da anahtarda düzeltme gerektirir.