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 API’si, Türkiye SMS aggregator’ları (NetGSM, İleti Merkezi, Verimor, Mutlucell, Vatansms), Telegram Bot API ve WhatsApp Business Cloud API üzerinde tek bir RESTful arayüz sunar.

​
Sürümleme

Tüm uç noktalar /v1 öneki taşır. Geriye-uyumsuz değişiklikler yeni sürüm (/v2, …) altında yayımlanır; mevcut sürüm en az 12 ay desteklenir. Aşağıdaki değişiklikler geriye uyumlu sayılır ve sürüm değiştirmez:
  • Yanıta yeni alan ekleme
  • Yeni isteğe bağlı parametre ekleme
  • Yeni event tipi ekleme
  • Yeni endpoint ekleme
  • Yeni hata kodu ekleme

​
İstek Formatı

ÖzellikDeğer
ProtokolHTTPS zorunludur. HTTP istekleri reddedilir.
Content-Typeapplication/json (body gönderen tüm istekler için).
EncodingUTF-8. Türkçe karakterler (ç ğ ı İ ö ş ü) doğrudan kullanılabilir.
Maks. gövde1 MB

​
Yanıt Formatı

Başarılı yanıtlar 2xx HTTP koduyla doğrudan kaynak nesnesini döner — sarıcı/zarf yoktur: 
{
  "job_id": "k7m4n2p9q8r5s1t6",
  "status": "sent",
  ...
}
Hatalı yanıtlar standart bir hata zarfı kullanır — bkz. Hatalar.

​
Rate Limit

SınırDeğer
API key başına istekWorkspace planına göre (varsayılan: 60 istek/dk)
Toplu gönderim öğe sayısı200
Mesaj gövdesi1600 karakter
Alıcı alanı uzunluğu32 karakter
Limit aşıldığında 429 Too Many Requests döner. Retry-After başlığı saniye cinsinden bekleme süresini bildirir.

​
Idempotency

POST /v1/messages doğal olarak idempotent değildir — aynı isteği iki kez gönderirseniz iki mesaj gider. Retry mantığı kuruyorsanız, her isteği göndermeden önce kendi tarafınızda bir client_message_id üretip durum kontrolü yapın (örn. Redis SET-NX). Idempotency-Key başlığı yol haritasındadır, henüz aktif değildir.

​
Saat Dilimi & Zaman Damgaları

Tüm *_at alanları ISO 8601 / UTC formatındadır: 
2026-05-13T20:14:00.000Z
Yerel saat (+03:00) dönüşümü istemciye bırakılmıştır. created_at/sent_at/delivered_at alanları milisaniye hassasiyetinde döner.

​
Sayısal Tipler

  • Mesaj job_id’leri string’tir (16–32 hex karakter). Sayıya çevirmeyin.
  • Workspace id ve message_id alanları bigint’tir. JSON’da number olarak gelir; 2⁵³’ten büyük değerler nadirdir ama olası — string’e çevirip saklayın.
  • Para birimi alanları (cost) decimal string olarak döner (örn. "0.1500"), Number parse’inde precision kaybı olabilir.

​
SDK’lar

Resmi SDK paketleri yol haritasındadır. Şu an için API doğrudan HTTPS istekleri ile kullanılır; her sayfada cURL + Node.js + Python + PHP örnekleri sunulmuştur.