Hatalar, kotalar ve limitler

Hata zarfı, durum kodları ve kota/billing kesintisi davranışı.

1 dk okuma 3 bölüm

Hata zarfı#

Hata yanıtları error, message, statusCode ve requestId alanlarını içerir.

Hata yanıtı

{
  "error": "ForbiddenError",
  "message": "Gerekli yetkiler: links:write",
  "statusCode": 403,
  "requestId": "…"
}

Durum kodları#

Kod	Anlamı
`400`	Geçersiz body veya cursor
`401`	Anahtar yok, geçersiz, iptal edilmiş veya süresi dolmuş
`403`	Gerekli scope eksik
`409`	Idempotency çatışması (aynı anahtar, farklı payload)
`429`	Kota aşıldı; `Retry-After` kadar bekleyin
`503`	Billing kesintisi sırasında mutation; aynı idempotency anahtarıyla tekrar deneyin

Kotalar#

Her developer API çağrısı aylık monthlyApiCalls kullanımına yazılır; link, tree, board, route ve event işlemleri ayrıca plan kaynak kotalarını tüketir. Idempotent tekrarlar sayaçları iki kez artırmaz. Güncel kullanımınızı konsolun Kullanım sekmesinde görebilirsiniz.

Billing okuma/kontrol kesintisinde salt okunur istekler kontrollü olarak devam eder; yalnızca mutation'lar 503 ile durur.

Bir şey eksik veya hatalı mı? Destek ekibine yazın; yanıttaki X-Request-Id değerini eklemek çözümü hızlandırır.