Hata Kodları

Bir istek başarısız olduğunda, Chainabit API standart yanıt zarfı (EN) içinde yapılandırılmış bir hata yanıtı döndürür. Bu sayfa tüm hata kodlarını ve anlamlarını belgeler.

Hata Yanıtı Formatı

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description of the error",
    "details": {}
  },
  "meta": {
    "requestId": "req_abc123",
    "durationMs": 5
  }
}

details alanı isteğe bağlıdır ve mevcut olduğunda ek bağlam içerir (örneğin, alan düzeyinde doğrulama hataları).

Hata Kodları

Kod	HTTP Durumu	Açıklama
VALIDATION_ERROR	400	İstek gövdesi, sorgu parametreleri veya yol parametreleri doğrulamadan geçemedi.
UNAUTHORIZED	401	İstekte geçerli bir kimlik doğrulama belirteci eksik veya belirtecin süresi dolmuş.
FORBIDDEN	403	Kimliği doğrulanmış kullanıcının bu işlemi gerçekleştirme izni yok.
NOT_FOUND	404	İstenen kaynak mevcut değil veya kullanıcının buna erişimi yok.
RATE_LIMIT_EXCEEDED	429	Kullanıcı bu uç nokta için hız sınırını aştı.
INTERNAL_ERROR	500	Sunucuda beklenmeyen bir hata oluştu.

Örnekler

VALIDATION_ERROR (400)

İstek gövdesi beklenen şemayla eşleşmediğinde döndürülür.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "details": [
      {
        "field": "name",
        "message": "name must not be empty"
      },
      {
        "field": "cadence",
        "message": "cadence must be one of: daily, weekly, custom"
      }
    ]
  },
  "meta": {
    "requestId": "req_1a2b3c",
    "durationMs": 3
  }
}

UNAUTHORIZED (401)

Hiçbir belirteç sağlanmadığında veya belirtecin süresi dolduğunda ya da hatalı biçimlendirildiğinde döndürülür.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required"
  },
  "meta": {
    "requestId": "req_4d5e6f",
    "durationMs": 1
  }
}

FORBIDDEN (403)

Kullanıcının kimliği doğrulandığında ancak gerekli role veya yetkiye sahip olmadığında döndürülür.

{
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have permission to access this resource"
  },
  "meta": {
    "requestId": "req_7g8h9i",
    "durationMs": 2
  }
}

NOT_FOUND (404)

İstenen kaynak mevcut olmadığında veya kullanıcı tarafından erişilebilir olmadığında döndürülür.

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Chain not found"
  },
  "meta": {
    "requestId": "req_0j1k2l",
    "durationMs": 8
  }
}

RATE_LIMIT_EXCEEDED (429)

Kullanıcı uç nokta için hız sınırını aştığında döndürülür. Ayrıntılar için Hız Sınırlandırması bölümüne bakın.

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded"
  },
  "meta": {
    "requestId": "req_3m4n5o",
    "durationMs": 1
  }
}

INTERNAL_ERROR (500)

Beklenmeyen bir sunucu hatası oluştuğunda döndürülür. Bu hatayla sürekli olarak karşılaşırsanız destek ekibiyle iletişime geçin.

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred"
  },
  "meta": {
    "requestId": "req_6p7q8r",
    "durationMs": 150
  }
}

Bir dahili hatayı bildirirken, meta alanındaki requestId değerini ekleyin -- bu, destek ekibinin ilgili günlükleri bulmasına yardımcı olur.