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.

İletiniz, Türkiye’deki SMS sağlayıcıları (NetGSM, İleti Merkezi, Verimor, Mutlucell, Vatansms), Telegram Bot API ve WhatsApp Business Cloud’u tek bir REST arayüzü altında toplayan bir mesaj iletim platformudur. Bu dokümantasyon api.iletiniz.com üzerinden sunulan REST API’yi belgeler.

Hızlı Bakış

Düz Metin Gönder

POST /v1/messages — Tek bir alıcıya düz metin SMS, Telegram veya WhatsApp gönder.

Şablon ile Gönder

Dashboard’da tanımlı şablon ve değişkenlerle gönderim.

Toplu Gönderim

Tek istekte maks. 200 alıcıya düz metin veya şablonla.

Webhook'lar

Mesaj durumu değişikliklerini gerçek zamanlı HMAC-imzalı POST ile al.

Kimlik Doğrulama

iltz_live_… formatında API key ile Authorization: Bearer doğrulama.

İYS Uyumu

Ticari elektronik ileti izinleri ve API davranışı.

Base URL

https://api.iletiniz.com
API’nin tek bir ortamı vardır. Test gönderimi için iltz_test_… öneki taşıyan API key’lerini kullanabilirsiniz; bunlar gerçek SMS ücreti üretmez fakat sağlayıcıdan dönen yanıtı simüle eder.

İlk İstek

curl -X POST https://api.iletiniz.com/v1/messages \
  -H "Authorization: Bearer iltz_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+905551234567",
    "body": "Merhaba, bu bir test mesajıdır.",
    "sender": "FIRMA"
  }'
Yanıt (201 Created):
{
  "job_id": "k7m4n2p9q8r5s1t6",
  "status": "sent",
  "to": "+905551234567",
  "provider": "netgsm",
  "created_at": "2026-05-13T20:14:00.000Z"
}
job_id üzerinden teslim durumunu sorgulayabilir, veya bir webhook endpoint’i tanımlayarak status değişikliklerini push olarak alabilirsiniz.

API Surface

EndpointAçıklama
POST /v1/messagesTek mesaj gönderimi
POST /v1/messages/bulkToplu gönderim (≤ 200 öğe)
GET /v1/messages/{job_id}Mesaj durumu sorgulama
GET /v1/healthSağlık probe (auth gerekmez)
Bunun dışındaki kaynak yönetimi (workspace, API key, provider bağlantısı, şablon, webhook endpoint) dashboard üzerinden yapılır: iletiniz.com.