Hata başvurusu - Pactmark

Uyumluluk: Pactmark 0.2.x. Kodlar kararlı API’dir. İngilizce mesajlar tanılamadır ve her an değişebilir.

Kural

// Yanlış
if (error.message.includes("policy")) { /* … */ }

// Doğru
if (error.code === "KAF_POLICY_DENIED") { /* … */ }

Her başarısızlık bir KAF_* kodu taşır. Yalnızca koda göre dallanın.

Serileştirme ve şema

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_SCHEMA_INVALID`	hayır	400	Değer gereken şemayla eşleşmiyor
`KAF_SERIALIZATION_INVALID_JSON`	hayır	400	JSON gösterimi geçersiz
`KAF_SERIALIZATION_DUPLICATE_KEY`	hayır	400	JSON gösteriminde yinelenen anahtar var
`KAF_SERIALIZATION_INVALID_UNICODE`	hayır	400	Değer geçersiz Unicode içeriyor
`KAF_SERIALIZATION_NON_I_JSON_NUMBER`	hayır	400	Değer I-JSON olmayan bir sayı içeriyor
`KAF_SERIALIZATION_UNSUPPORTED_VALUE`	hayır	400	Değer kanonik JSON olarak temsil edilemiyor
`KAF_SERIALIZATION_CYCLIC_VALUE`	hayır	400	Değer bir döngü içeriyor

Çalışma zamanı ve geçişler

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_RUNTIME_INVALID_TRANSITION`	hayır	409	Koşu olayı mevcut durumda geçerli değil
`KAF_RUNTIME_TERMINAL`	hayır	409	Koşu zaten sonlanmış
`KAF_RUNTIME_EVENT_SEQUENCE`	evet	409	Olay sırası saklanan durumla çakışıyor
`KAF_RUNTIME_EVENT_BINDING`	hayır	409	Olay bu koşu tanımına ait değil
`KAF_RUNTIME_AGENT_DEFINITION_MISMATCH`	hayır	409	Kayıtlı ajan tanımı kabul edilen koşuyla eşleşmiyor
`KAF_RUNTIME_CAPABILITY_MISSING`	hayır	503	Gereken bir çalışma-zamanı yeteneği yok
`KAF_RUNTIME_NOT_READY`	hayır	503	Çalışma zamanı istenen profil için hazır değil

KAF_RUNTIME_EVENT_SEQUENCE yeniden denenebilirdir; çünkü başka bir yazıcının önce davrandığı anlamına gelir — yeniden oku ve tekrar dene doğru yanıttır. KAF_RUNTIME_TERMINAL değildir; çünkü hiçbir yeniden deneme bir koşuyu sonlanmamış hâle getirmez.

Yetki ve politika

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_AUTHORIZATION_BINDING_MISMATCH`	hayır	403	Yetkilendirme, istenen işlemle eşleşmiyor
`KAF_AUTHORIZATION_EXPIRED`	hayır	403	Yetkilendirmenin süresi dolmuş
`KAF_POLICY_DENIED`	hayır	403	Politika işlemi reddetti
`KAF_ADMISSION_DENIED`	evet	429	Yapılandırılmış admission veya kota sınırına ulaşıldı

Etkiler

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_EFFECT_INVALID_TRANSITION`	hayır	409	Etki olayı mevcut durumda geçerli değil
`KAF_EFFECT_ABANDONED_UNCERTAIN`	hayır	409	Belirsiz etki terk edildi ve gerçekleşmiş olabilir

KAF_EFFECT_ABANDONED_UNCERTAIN “başarısız oldu” demek değildir. “Bilmiyoruz ve beklemeyi bıraktık” demektir. Bunun aşağısındaki her şeyi, bir insan gerçeği tespit edene kadar çözülmemiş sayın.

Depolama

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_STORAGE_CONCURRENCY_CONFLICT`	evet	409	Saklanan durum eşzamanlı olarak değişti
`KAF_STORAGE_NOT_FOUND`	hayır	404	İstenen kaynak bulunamadı
`KAF_STORAGE_SECURITY_PROFILE`	hayır	503	Depolama güvenlik profili bu işlemi kabul edemiyor

KAF_STORAGE_NOT_FOUND, “yok” ve “var ama sizin değil” için kasıtlı olarak aynı yanıttır. Ret bir sayım kâhinine dönüşmemelidir.

Model sınırı

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_MODEL_RESOURCE_LIMIT_EXCEEDED`	hayır	422	Model çağrısı kayıtlı kaynak profilini aştı
`KAF_MODEL_CREDENTIAL_REQUIRED`	hayır	503	Model kimlik bilgisi sınırı kullanılamıyor
`KAF_MODEL_ADAPTER_MISMATCH`	hayır	409	Model adaptörü kayıtlı model profiliyle eşleşmiyor

Doğrulama, kanıt ve desenler

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_VERIFICATION_REQUIRED`	hayır	409	Gereken doğrulama geçmedi
`KAF_EVIDENCE_INVALID_REFERENCE`	hayır	409	Kanıt eksik veya uyumsuz bir kayda işaret ediyor
`KAF_PATTERN_INSUFFICIENT_EVIDENCE`	hayır	409	Kanıt istenen desen olgunluğunu desteklemiyor

Komutlar ve idempotency

Kod	Yeniden denenebilir	HTTP	Anlamı
`KAF_COMMAND_IDEMPOTENCY_EXPIRED`	hayır	409	Komut idempotency ufku geçti
`KAF_HTTP_IDEMPOTENCY_CONFLICT`	hayır	409	Idempotency anahtarı farklı içerik için zaten kullanıldı

Doğru yeniden deneme

Yalnızca tipli sınıflandırma ve etki stratejisi izin verdiğinde yeniden deneyin. Bir zaman aşımı veya kaybolan taşıma, dış bir etkinin gerçekleşmediği anlamına gelmez — etki defterinin var olma nedeni tam olarak bu durumdur.

Kaydın tamamında yalnızca üç kod yeniden denenebilir olarak işaretlidir: KAF_RUNTIME_EVENT_SEQUENCE, KAF_ADMISSION_DENIED ve KAF_STORAGE_CONCURRENCY_CONFLICT. Üçü de aynı isteğin güvenle tekrarlanabildiği çekişme veya kota durumlarıdır.

Hat üzerindeki biçim

{
  "type": "https://pactmark.dev/errors/policy-denied",
  "title": "KAF_POLICY_DENIED",
  "status": 403,
  "code": "KAF_POLICY_DENIED",
  "detail": "Policy denied the operation."
}

Problem Details, kod bir istemcinin gerçekte bakacağı yerde tekrarlanmış hâlde. Yanıt gövdeleri ve loglar farklı açıklama seviyeleri kullanır — bir yanıt kasıtlı olarak daha azını gösterir.

Koşu olayları

RunFailed.errorCode bu kaydı kullanır.

HTTP API

Her durumun hat üzerinde nerede göründüğü.

​Kural

​Serileştirme ve şema

​Çalışma zamanı ve geçişler

​Yetki ve politika

​Etkiler

​Depolama

​Model sınırı

​Doğrulama, kanıt ve desenler

​Komutlar ve idempotency

​Doğru yeniden deneme

​Hat üzerindeki biçim

Koşu olayları

HTTP API

Kural

Serileştirme ve şema

Çalışma zamanı ve geçişler

Yetki ve politika

Etkiler

Depolama

Model sınırı

Doğrulama, kanıt ve desenler

Komutlar ve idempotency

Doğru yeniden deneme

Hat üzerindeki biçim