Skip to main content

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.

POST /v1/messages
Tek bir alıcıya düz metin mesaj gönderir. Şablon kullanmak istiyorsanız Şablon ile Gönderim sayfasına bakın.

​
İstek

​
Başlıklar

BaşlıkDeğer
AuthorizationBearer iltz_live_… veya Bearer iltz_test_…
Content-Typeapplication/json

​
Gövde

AlanTipZorunluAçıklama
tostring (1–64)EvetAlıcı. SMS için TR cep numarası (+90..., 0..., 5... kabul edilir, E.164’e normalize edilir). Telegram için chat_id veya @kullanici_adi. WhatsApp için E.164 numarası.
bodystring (1–1600)EvetMesaj gövdesi.
senderstring (≤ 32)SMS için zorunluOnaylı msgheader (gönderici başlığı). Telegram/WhatsApp için yok sayılır. Boş bırakılırsa bağlantı varsayılanı kullanılır.
providerstring (≤ 64)HayırBelirli bir sağlayıcı bağlantısı zorla (netgsm, verimor, iletimerkezi, mutlucell, vatansms, telegram, whatsapp). Birden fazla bağlantı varken yararlıdır.
body alanı zorunludur. Şablon kullanmak için bu uç nokta yerine Şablon ile Gönderim sayfasını kullanın — orada template + variables parametreleri açıklanmıştır.

​
Örnekler

curl -X POST https://api.iletiniz.com/v1/messages \
  -H "Authorization: Bearer iltz_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+905551234567",
    "body": "Doğrulama kodunuz: 482931",
    "sender": "FIRMA"
  }'

​
Yanıt

201 Created 
{
  "job_id": "k7m4n2p9q8r5s1t6",
  "status": "sent",
  "to": "+905551234567",
  "provider": "netgsm",
  "created_at": "2026-05-13T20:14:00.000Z"
}

​
Yanıt Alanları

AlanTipAçıklama
job_idstringMesaja atanmış benzersiz kimlik. GET /v1/messages/{job_id} ile durum sorgulayın.
statusenumsent (sağlayıcıya iletildi), queued (kuyrukta), failed (sağlayıcı reddetti).
tostringE.164 formatında normalize edilmiş alıcı.
providerstringKullanılan sağlayıcı kodu.
errorobject?status: "failed" ise sağlayıcının dönen hata kodu/mesajı.
created_atstring (ISO 8601)İsteğin alındığı an, UTC.
status: "sent" mesajın sağlayıcıya teslim edildiği anlamına gelir — alıcının cihazına ulaştığı değil. Final teslim durumu (delivered, expired, rejected, failed, unknown) DLR raporlarıyla netleşir ve GET /v1/messages/{job_id} veya webhook’lar üzerinden öğrenilir.

​
İYS (Türkiye)

SMS gönderimleri 5809 sayılı Elektronik Ticaretin Düzenlenmesi Hakkında Kanun ve İYS (İleti Yönetim Sistemi) gereklilikleri doğrultusunda yapılır. Detaylar için İYS Uyumu sayfasına bakın. Ticari içerikli SMS göndermek için alıcı izninin İYS’te kayıtlı olması zorunludur; sağlayıcılar bunu kendi tarafında denetler ve izinsiz gönderim failed döner.

​
Hata Yanıtları

KodSebep
400Şema doğrulaması başarısız (boş to, body eksik, vb.)
401API key yok / yanlış / revoke edilmiş
403IP allowlist’ten geçemedi
404Belirtilen provider workspace’te bağlı değil
422TR olmayan numara, Telegram chat_id bot için erişilemez, onaysız sender
429Rate limit aşıldı
5xxSağlayıcı upstream’e ulaşılamadı veya sunucu hatası
Hata gövdesi formatı için Hatalar sayfasına bakın.