Hatalar

Hatalar RFC 9457(yeni sekmede açılır) sorun belgeleridir (Content-Type: application/problem+json):

{
  "type": "about:blank",
  "title": "Invalid request",
  "status": 400,
  "detail": "unknown country",
  "code": "unknown_country",
  "request_id": "01a166eb2f3a76c8b7c8a8c37d21aae3"
}

code kalıcıdır ve programlar içindir. Kararı ona göre verin; ifadesi değişebilen detail alanına göre değil.
request_id ayrıca X-Request-Id başlığında da gönderilir. Destek ekibiyle iletişime geçtiğinizde bu değeri belirtin. Günlükleri ilişkilendirmek için kendi X-Request-Id değerinizi (harf, rakam, ., _ ya da - karakterlerinden oluşan 8 ile 64 karakter) gönderebilirsiniz.
Şemaya uymayan bir girdi, invalid_request koduyla 400 ve bir errors listesi döndürür: her alan için bir JSON işaretçisi (JSON pointer), bir kod ve bir ileti.

Durum kodları

Durum	Anlamı	Yeniden denenir mi?
400	İstek geçerli değil (nedenini `code` söyler)	Düzelttikten sonra
401	Kimlik bilgisi yok ya da geçerli değil	Düzelttikten sonra
403	Kimlik bilgisi geçerli, ama izin yok (`code` nedenini söyleyebilir, ör. `no_org_read`)	Hayır
404	Bulunamadı ya da size ait değil (API ikisini ayırt etmez)	Hayır
409	Güncel durumla çakışıyor (hangisi olduğunu `code` söyler)	Durumu yeniden okuduktan sonra
413	Gövde çok büyük	Hayır
429	Hız sınırı ya da günlük kota (`rate_limited`, `quota_exceeded`)	`Retry-After` süresi geçtikten sonra
5xx	Bizim ya da bir iş ortağının hatası (`escrow_unavailable` gibi bir `code` ile `503`)	Artan bekleme süreleriyle

Sık karşılaşacağınız kodlar: invalid_request, unauthorized, forbidden, not_found, rate_limited, quota_exceeded, personal_data (bir metinde telefon numarası, e-posta adresi ya da kimlik numarası vardı), unknown_country, webhook_url_refused, unknown_event_types, too_many_webhooks, rotation_pending, webhook_disabled. Bir işlemin döndürebileceği her kod OpenAPI belgesinde listelenir.