Hata kodları

HTTP durumları

| Kod | Anlamı | | --- | --- | | 400 | İstek doğrulaması başarısız. | | 401 | Token eksik veya geçersiz. | | 403 | Kullanıcının işlem için yetkisi yok. | | 404 | Kaynak bulunamadı. | | 409 | Aynı referansla çakışan işlem var. | | 422 | Operasyonel doğrulama hatası. | | 429 | Rate limit aşıldı. | | 500 | Beklenmeyen sunucu hatası. |

Örnek hata yanıtı

{
  "error": {
    "code": "invalid_recipient_address",
    "message": "Alıcı adresi taşıyıcı doğrulamasından geçemedi.",
    "requestId": "req_01HX..."
  }
}

Retry yaklaşımı

• 429 yanıtlarında Retry-After başlığını dikkate alın.
• 5xx hatalarında kısa aralıklarla sınırlı retry uygulayın.
• 4xx doğrulama hatalarında kullanıcı veya veri düzeltmesi gerekir.