Hatalar

{ "error": { "code": "<snake_case>", "message": "<okunabilir>", "details": [ { "path": "…", "message": "…" } ] } }

details yalnızca doğrulama hatalarında bulunur.

Durum	code	Anlamı	Yapın
400	unknown_kind	/v1/e/:kind d, o, c, x'ten biri değil	yolu düzeltin
400	invalid_msg_id	izleme kimliği HMAC doğrulamasından geçmedi	push bu kurulumdan değil ya da HMAC_SECRET değişti
400	invalid_idempotency_key	başlık 255 karakterden uzun	kısaltın
401	unauthorized	anahtar yok, bozuk, bilinmiyor ya da iptal edilmiş	başlığı ve uygulamayı kontrol edin
403	forbidden	sunucu ucunda public anahtar ya da anahtarda kapsam yok	doğru kapsamlı sunucu anahtarı kullanın
404	not_found	bu uygulamada böyle abonelik/kullanıcı/kampanya yok	yabancı id, olmayanla aynı görünür
409	invalid_state	kampanya mevcut durumundan gönderilemez/iptal edilemez; henüz içerik yok	status'a bakın; taslağı bitirin
409	idempotency_in_progress	bu anahtarla ilk istek hâlâ çalışıyor	biraz sonra tekrar deneyin
409	çeşitli (kazanan)	deney değil, kalan yok, zaten gönderildi, hâlâ gönderiliyor	mesaja bakın
422	invalid_body	zod doğrulaması başarısız	details[].path'i okuyun
422	invalid_segment	segment DSL derlenmedi	details[0].path'i okuyun
422	idempotency_key_reused	aynı anahtar, farklı gövde	niyet başına yeni anahtar kullanın
429	rate_limited	pencere doldu	mesajdaki saniye kadar bekleyin
500	upsert_failed	Mongo upsert'te doküman döndürmedi	tekrar deneyin; günlüklere bakın
503	database_unavailable	MongoDB ulaşılamaz	backoff ile tekrar deneyin; /health de 503'tür
503	encryption_key_missing	ENCRYPTION_KEY'siz admin yüzeyi	API'yi yapılandırın
404	— (gövde yok)	ADMIN_API_TOKEN ayarsız ya da yanlışken herhangi bir /v1/admin/* yolu	kasıtlı: token olmadan yüzey yoktur

details'i okuma

"details": [
  { "path": "content.en.image", "message": "Invalid url" },
  { "path": "target", "message": "provide exactly one of externalIds, userIds, subscriptionIds, segment or all" },
  { "path": "schedule.localTime", "message": "expected HH:MM" }
]

path istek gövdenizdeki noktalı yoldur. Boş yol bütün gövde demektir (örn. PATCH'te "no updatable fields given").