Documentation Index
Fetch the complete documentation index at: https://docs.iletiniz.com/llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/messages/{job_id}
job_id üzerinden bir mesajın güncel teslim durumunu döner.
Yol Parametreleri
| Parametre | Tip | Açıklama |
|---|
job_id | string (16–32 hex) | POST /v1/messages veya bulk yanıtında dönen kimlik. |
Örnek
curl https://api.iletiniz.com/v1/messages/k7m4n2p9q8r5s1t6 \
-H "Authorization: Bearer iltz_live_xxxxxxxxxxxxxxxxxxxxxxxx"
Yanıt
200 OK
{
"job_id": "k7m4n2p9q8r5s1t6",
"status": "delivered",
"to": "+905551234567",
"provider": "netgsm",
"created_at": "2026-05-13T20:14:00.000Z",
"sent_at": "2026-05-13T20:14:01.230Z",
"delivered_at": "2026-05-13T20:14:04.512Z"
}
Durum Değerleri
status | Anlamı | Final mi? |
|---|
queued | Kuyrukta, henüz sağlayıcıya iletilmedi (nadir). | Hayır |
sent | Sağlayıcıya iletildi, DLR bekleniyor. | Hayır |
delivered | Operatör tarafından alıcının cihazına teslim edildi. | Evet |
failed | Sağlayıcı veya operatör reddetti (operatör hatası, geçersiz numara, İYS engeli). | Evet |
expired | Sağlayıcı, TTL içinde teslim edemedi (alıcı kapalı, sinyal yok). | Evet |
rejected | Alıcı kara liste, opt-out, içerik filtresi. | Evet |
unknown | DLR sorgusu sınırlı sayıda denemeye rağmen kesin sonuç alamadı. | Evet |
message.delivered veya message.failed) tetiklenir — bkz. Webhook Event’leri.
Yanıt Alanları
| Alan | Açıklama |
|---|
job_id | İstek kimliği. |
status | Yukarıdaki tabloda listelenen değerlerden biri. |
to | E.164 / chat_id formatında alıcı. |
provider | Kullanılan sağlayıcı kodu. |
error | failed/rejected durumunda { code, message }. |
created_at | İstek alındığında. |
sent_at | Sağlayıcıya teslim edildiğinde (null ise henüz iletilmedi). |
delivered_at | DLR ile teslim onaylandığında (null ise final değil veya teslim onaylanmadı). |
Hata Yanıtları
| Kod | Sebep |
|---|
401 | API key yok / yanlış. |
404 | job_id bu workspace’in mesajlarına ait değil. |
Yoğun pipeline’larda her mesaj için poll etmek yerine webhook’lara abone olun — DLR geldiğinde endpoint’inize push edilir, gereksiz GET trafiği oluşmaz. 
