Hatalar

Bu sayfa her başarısız API isteğinin döndürdüğü hata gövdesini anlatır ve kodda bulunan her hata kodunu listeler. src/cluster_erp/core/errors.py içindeki 213 kod sabitini, modüllerin ve sunucu dosyalarının yerel olarak tanımladığı kodları ve src/cluster_erp/server/error_handler.py içindeki istisna işleyicilerinin atadığı kodları kapsar. Hata modelinin tasarımı Hatalar ve istisnalar sayfasında anlatılır.

Hata gövdesi¶

Her işleyici gövdeyi _build_body ile kurar. src/cluster_erp/server/error_handler.py:33-46 içinden:

def _build_body(
    code: str,
    message: str,
    trace_id: str,
    details: dict[str, Any] | None = None,
) -> dict[str, Any]:
    body: dict[str, Any] = {
        "code": code,
        "message": message,
        "trace_id": trace_id,
    }
    if details:
        body["details"] = details
    return {"error": body}

_build_body ve RESOURCE_NOT_FOUND fabrikası not_found (src/cluster_erp/core/errors.py:357-367) üzerine kurulan örnekleyici yanıt:

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Warehouse (<warehouse_id>) not found",
    "trace_id": "<yymmdd>-<seq>",
    "details": {"resource": "Warehouse", "id": "<warehouse_id>"}
  }
}

İstisna işleyicileri¶

install_error_handlers istisna sınıfı başına bir işleyici kaydeder (src/cluster_erp/server/error_handler.py:200-398). Tablo her birinin ne ürettiğini listeler.

Her yola ortak kodlar¶

Kimlik doğrulama, yetki ve yetkilendirme denetimleri işleyiciden önce çalışır ve her yolu yanıtlayabilir. Yetkilendirme kapısı sözlük detail ile HTTPException atar; kod gövdeye code olarak ulaşır (src/cluster_erp/server/entitlements.py:233-257, src/cluster_erp/server/error_handler.py:252-262).

Çekirdek hata modülünde tanımlı kodlar¶

src/cluster_erp/core/errors.py içindeki her yorum bölümü için bir tablo. Durum, atma konumu sayısı ve ilk konum; src/cluster_erp/ üzerinde AppError(...), core/errors.py fabrikaları ve HTTPException(...) için yapılan sözdizimi ağacı taramasından gelir. İleti sütunu ilk konumdaki İngilizce iletiyi alıntılar; kodun belirttiği nedendir. Atma konumu olmayan kod tanımlıdır ama taranan hiçbir çağrı onu atmaz. İstisna işleyicilerinin atadığı kodlar bunun yerine işleyiciyi gösterir.

Aynı dosyanın iş bölümlerindeki kodlar (CRM'den satın almaya) İş hata kodları sayfasında listelenir.

Kimlik doğrulama¶

Kaynak CRUD¶

Doğrulama¶

İş mantığı¶

Para birimi¶

Eşzamanlılık¶

Dış hizmetler¶

Veritabanı¶

Serileştirme¶

Çalışma zamanı¶

Sunucu¶

Çekirdek hata modülü dışında tanımlı kodlar¶

Bu kodlar bir modül veya sunucu dosyasındaki dizge sabitleri ya da değişmezleridir. Satırlar ilk atma konumunun klasörüne göre gruplanır.

Genel HTTP kodları¶

Düz detail taşıyan bir HTTPException HTTP_<status> olur (src/cluster_erp/server/error_handler.py:251).

İlgili sayfalar¶

• API başvurusu
• İş hata kodları
• Hatalar ve istisnalar
• Kimlik doğrulama ve başlıklar
• API kuralları

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.