Yanıt ve hatalar

Başarılı gövde kaydın kendisidir; bir zarf yoktur. Liste uçları { items, total, page, limit, totalPages } döner.

Doğrulama

Geçersiz gövde 400 döner. Gerekçe errors dizisindedir ve Türkçedir. Mesajlar DTO’dan gelir; alan adının altındaki constraints değerini olduğu gibi gösterebilirsiniz.

{
  "message": "Validation error",
  "errors": [
    {
      "property": "message",
      "constraints": {
        "length": "Mesaj 1 ile 1600 karakter arasında olmalıdır"
      }
    }
  ]
}

message sabittir, kullanıcıya onu değil constraints içindeki metni gösterin. İç içe dizilerde (data satırları) gerekçe üst alana, satır numarasıyla taşınır: 1. satır: ….

Durum kodları

Kod	Anlam
400	Gövde veya iş kuralı geçersiz. Metin message ya da errors içindedir. Kontör yetersizliği de burada döner.
401	Anahtar veya token yok, süresi dolmuş ya da parola değişince düşmüş.
403	Kimlik geçerli, bu uç için izin yok ya da istemci IP’si anahtarın listesinde değil.
404	Gönderim veya alıcı yok. Başka kullanıcının kaydı da 404 döner.
413	Gövde 10 MB’ı aşıyor.
201	Oluşturuldu.
202	Kabul edildi; liste ve gönderim arka planda sürüyor.
503	Kontör bakiyesi şu an okunamadı; gönderim oluşmadı.

Beklenmeyen bir hata 500 ve kısa bir message döner. Ayrıntı yanıtta yoktur.

Sık gerekçeler

Uç açıklamasındaki hata listesi servisin döndürdüğü metindir. En çok görülenler:

Metin	Ne zaman
Kontör yetersiz (gerekli X, mevcut Y)	Tahmini parça sayısı bakiyeyi aşıyor; paket açılmadı.
Alıcı verisi geçersiz	data satırlarından biri bozuk. Ayrıntıda en çok 20 satır row ve reason ile döner.
phone zorunludur	Satırda numara yok.
Telefon numarası geçersiz: …	Numara +90… biçimine çevrilemedi.
Geçerli bir telefon numarası giriniz	Alıcı listesindeki phone süzgeci geçersiz.
Teslim durumu geçersiz	deliveryState bilinen değerlerden biri değil.
data zorunludur	Gövdede data yok.
yer tutucu için eksik anahtar	{ad} var ama o satırda ad boş; gerekçede satır numarası bulunur.