iletiMerkezi API Hata Kodları

Bu sayfa, iletiMerkezi REST API'sinin yanıt gövdesinde döndüğü tüm response.status.code değerlerini ve karşılık gelen Türkçe mesajları listeler. Kodlar HTTP durum kodu ile uyumlu çalışır ama bazı senaryolarda (örn. 4xx aralığındaki "iş kuralı" hataları) iç durum kodu daha spesifiktir.

Genel akış

• Başarılı yanıt: code: 200, message: "İşlem başarılı". Endpoint'e özgü ek alanlar (order, balance, senders, blacklist) response altında gelir.
• Hatalı yanıt: code 4xx veya 5xx aralığında. response.{order,balance,...} döndürülmez; sadece response.status gelir.

Auth başarısızlığı (401) için ayrıntı: authentication. En yaygın "ilk-deneme" 401'i, panelde API kullanımına izin ver seçeneğinin kapalı olmasıdır, anahtar/hash hatası değil.

Mesaj ve sipariş durum kodları (raporlama)

Bu kodlar get-report yanıtının order.status ve message[].status alanlarında görünür.

Mesaj durumu (message[].status)

Sipariş durumu (order.status)

114 "her şey teslim edildi" demek değildir; sadece "gönderim akışı bitti". Gerçek teslim için delivered ve undelivered sayaçlarına bakın (get-report).

Genel durum kodları

SMS gönderim hataları

send-sms çağrılarında en sık karşılaşılan kodlar.

451, 452, 468, 469 için pratik notlar send-sms sayfasının "Common Pitfalls" bölümünde.

Rehber ve grup hataları

contacts ve groups endpoint'leri için.

Numara engelleme hataları

add-blacklist ve delete-blacklist için.

474 kodu delete-blacklist çağrısında numara hesabınızda kayıtlı değilse döner; add-blacklist'in idempotent davranışından farklı (memory: bu davranış 2026-04-29 canlı testinde gözlemlendi).

İYS izin hataları

iys-register ve iys-check için.

403 İYS marka kodu (brandCode) tanımlı değilse veya İYS hizmeti pasifse döner; çözümü panelden marka kayıt başvurusunu başlatmaktır.

475 iys-register'in consent.list dizisinin 5000'i geçmesi durumunda döner; listeyi 5000'lik dilimlere bölüp ardışık çağırın. iys-check tek alıcılıdır, bu hata orada görülmez.

iys-register ile gönderilen consent.list batch atomic'tir: tek bir kayıt 422'ye düşerse hiçbir kayıt persist olmaz. 422'nin yaygın nedenleri: consentDate 3 günden eski, recipient format hatalı, enum dışı recipientType / type / status / source.

Yanıt iskeleti

Tüm hata yanıtları aşağıdaki yapıdadır:

{
  "response": {
    "status": {
      "code": 4XX,
      "message": "Türkçe açıklama"
    }
  }
}

response.status.code integer olarak döner; response.status.message her zaman Türkçe'dir. İstemci kodunuzda mesaj string'ine değil, code değerine göre dallanın (mesaj metinleri zaman içinde değişebilir; kodlar stabildir).

Related

• Kimlik doğrulama (authentication)
• SMS gönderme (send-sms)
• Sipariş raporu (get-report)

Son güncelleme: 2026-04-29 · English version