iletiMerkezi API Dokümantasyonu
iletiMerkezi REST API'si, Türkiye merkezli SMS altyapısının üzerinde HTTP/JSON arayüzü. Tek API anahtarıyla SMS gönderimi, teslimat raporu, bakiye sorgu, sender ID yönetimi, kara liste işlemleri ve gelen SMS okuma yapılır.
Hızlı başlangıç: Kimlik Doğrulama > Bakiye > SMS Gönderme
Endpoint listesi
| Endpoint | Method + Path | Amaç |
|---|---|---|
| authentication | kavram | API Key + Hash sistemi, panel ön koşulu, 401 hata akışı |
| send-sms | POST /v1/send-sms/json | Tek veya çoklu numaraya SMS gönder |
| cancel-order | POST /v1/cancel-order/json | İleri tarihli siparişi iptal et |
| get-report | POST /v1/get-report/json | Tek sipariş teslimat raporu (mesaj-bazında detay) |
| get-reports | POST /v1/get-reports/json | Tarih aralığında sipariş özet listesi |
| get-balance | POST /v1/get-balance/json | Bakiye ve kontör miktarı |
| get-sender | POST /v1/get-sender/json | Onaylı sender ID listesi |
| get-blacklist | POST /v1/get-blacklist/json | Engellenmiş numara listesi |
| add-blacklist | POST /v1/add-blacklist/json | Numarayı kara listeye ekle |
| delete-blacklist | POST /v1/delete-blacklist/json | Numara engellemesini kaldır |
| iys-register | POST /v1/consent/create/json | İYS izin kaydı (toplu, max 5000) |
| iys-check | POST /v1/consent/show/json | İYS izin durumu sorgulama (tekil) |
| webhooks | yapılandırma | Gerçek zamanlı teslimat raporu callback'i |
| error-codes | referans | Tüm durum kodları ve mesajları |
| test-mode | kavram | Sandbox yok, güvenli test pattern'leri |
| overview | genel bakış | Ortak istek/yanıt yapısı, SDK'lar, Türkiye'ye özgü konular |
Temel bilgiler
| Alan | Değer |
|---|---|
| Base URL | https://api.iletimerkezi.com |
| Versiyon prefix | /v1 |
| Method | Tüm endpoint'ler POST |
| Content-Type | application/json |
| Auth | API Key + Hash, gövde içinde (request.authentication) |
| Mesaj dili | Sunucu yanıt mesajları her zaman Türkçe |
Detaylı genel bakış, SDK listesi ve Türkiye'ye özgü konular için: API Genel Bakış.
Related
- Genel Bakış (overview)
- Kimlik Doğrulama (authentication)
- Test ve Geliştirme (test-mode)
- Hata Kodları (error-codes)
Son güncelleme: 2026-04-29 · English version