API Hataları

API, hataları standart HTTP durum kodları ve tekdüzen yanıt gövdesiyle bildirir. Başarılı yanıtlar verileri doğrudan döndürür, sarmalayıcı kullanılmaz.

Hata Biçimi

Hata durumunda yanıt gövdesi, insan tarafından okunabilir bir mesaj içeren error alanına sahip bir JSON nesnesidir:

{"error":"reaction not found"}

Öncelikle HTTP durum koduna göre hareket edin; error metnini günlükler ve kullanıcı ipuçları için kullanın.

Durum Kodları

  • 200 OK — istek başarılı, gövdede veriler mevcut.
  • 201 Created — yeni kaynak oluşturuldu (bazı POST uç noktaları).
  • 204 No Content — gövdesiz başarı (bazı silme işlemleri).
  • 400 Bad Request — hatalı gövde veya istek parametreleri.
  • 401 Unauthorized — token eksik, hatalı veya süresi dolmuş; ya da rota kişisel tokenle erişilebilir değil.
  • 402 Payment Required — eylem bir plan veya kotayla sınırlandırılmış (örn. kendi medya depolama alanı premium gerektirir).
  • 403 Forbidden — token, bu rota için gerekli erişim kapsamına sahip değil.
  • 404 Not Found — kaynak bulunamadı veya size ait değil.
  • 409 Conflict — durum çakışması (örn. benzersiz değer tekrarı).
  • 422 Unprocessable Entity — gövde sözdizimsel olarak geçerli ancak alan doğrulamalarını geçemiyor.
  • 429 Too Many Requests — istek limiti aşıldı (bkz. limitler).
  • 500 Internal Server Error — dahili sunucu hatası; daha sonra tekrar deneyin.

Nasıl İşlenir

2xx kodlarını başarı olarak kabul edin. 401/403 alındığında tokeni ve erişim kapsamlarını kontrol edin. 4xx (429 hariç) kodlarında isteği değiştirmeden tekrar göndermeyip isteği düzeltin. 429 ve 5xx için üstel geri çekilmeyle yeniden deneme uygundur.

Sonraki Adımlar