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 önceden tanımlı şablon ile mesaj gönderir. Bu sayfa, Tek Mesaj Gönder uç noktasının şablon modunu açıklar — istek aynı endpoint’e gider, body yerine template + variables kullanılır.
body ve template alanlarından tam olarak biri zorunludur. Aynı anda ikisini de gönderirseniz 400 Bad Request döner.

​
İstek Gövdesi

AlanTipZorunluAçıklama
tostring (1–64)EvetAlıcı (kanal-bağımlı).
templatestringEvetŞablonun key değeri. ^[a-z0-9_]{1,64}$
variablesobjectŞartlıŞablon body’sindeki değişkenlere karşılık gelen değerler. Şablon değişkensizse boş bırakılabilir.
senderstring (≤ 32)SMS içinOnaylı msgheader. Telegram/WhatsApp’ta yok sayılır.
providerstringHayırSağlayıcı kodu (netgsm, verimor, …).
variables değerleri string veya number olabilir; number ise gönderim öncesi otomatik String() ile dönüştürülü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",
    "template": "siparis_onay",
    "variables": {
      "isim": "Ayşe",
      "siparis_no": "K-2024-8821"
    },
    "sender": "FIRMA"
  }'

​
Yanıt

201 Created 
{
  "job_id": "k7m4n2p9q8r5s1t6",
  "status": "sent",
  "to": "+905551234567",
  "provider": "netgsm",
  "template": "siparis_onay",
  "template_key": "siparis_onay",
  "created_at": "2026-05-13T20:14:00.000Z"
}
Düz metin yanıttan tek farkı: template ve template_key alanlarının dönmesi. Bu sayede aynı yanıt nesnesini şablonsuz/şablonlu gönderimler arasında ortak işleyebilirsiniz.

​
Hata Yanıtları

Koderror.code (veya error)Sebep
400'body' veya 'template' alanlarından tam olarak biri zorunludur.İkisi birden gönderildi.
400missing_template_variablesŞablonda geçen bir değişken variables’ta yok. Eksik isimler missing dizisinde döner.
404template_not_foundBelirtilen template workspace’te yok veya silinmiş.
422invalid_recipientTR cep numarası formatına uymuyor / chat_id erişilemez.
Hata gövdesi formatı için Hatalar sayfasına bakın.

​
Eksik Değişken Örneği

İstek: 
{
  "to": "+905551234567",
  "template": "siparis_onay",
  "variables": { "isim": "Ayşe" }
}
Şablon body’si Merhaba {{isim}}, {{siparis_no}} hazır. ise yanıt: 
{
  "statusCode": 400,
  "message": "Şablon değişkenleri eksik: siparis_no",
  "error": "missing_template_variables",
  "missing": ["siparis_no"]
}

​
İlgili Sayfalar