Onaylı Başlık Listesi API (get-sender)

get-sender endpoint'i, hesabınızda tanımlanmış ve iletiMerkezi tarafından onaylanmış sender ID (başlık) listesini döner. send-sms çağrılarında order.sender alanına sadece bu listedeki başlıklardan biri yazılabilir; aksi halde mesaj gönderilemez. Yan etkisi yoktur, kontör harcamaz.

Önemli ön koşul: Panel'de API erişimi

Bu endpoint'i çağırmadan önce panelinizde API kullanımına izin ver seçeneğinin aktif olması gerekir.
Ayar yeri: panel.iletimerkezi.com → Ayarlar → Güvenlik → Erişim İzinleri
Aktif değilse istek 401 — Üyelik bilgileri hatalı ile döner. Detay: authentication.md

Endpoint

| Alan | Değer | |---|---| | Method | POST | | URL | https://api.iletimerkezi.com/v1/get-sender/json | | Content-Type | application/json | | Auth | API Key + Hash (request.authentication) |

Request

Şema

request
└─ authentication
   ├─ key (string, zorunlu)
   └─ hash (string, zorunlu)

get-sender ek alan beklemez.

Tam örnek

{
  "request": {
    "authentication": {
      "key": "API_KEY",
      "hash": "API_HASH"
    }
  }
}

Response

Başarılı (200)

{
  "response": {
    "status": {
      "code": 200,
      "message": "İşlem başarılı"
    },
    "senders": {
      "sender": [
        "eMarka Test"
      ]
    }
  }
}

Alanlar:

response.senders.sender (string[]): Onaylı başlık listesi. Hesapta tek başlık varsa dizi tek elemanlı, birden çok başlık varsa ona göre uzar. Maksimum 11 karakter, alfanumerik (boşluk dahil).

Yeni hesaplarda liste boş olabilir; başlık başvurusu panelden yapılır ve onay süreci 1-2 iş günü sürer. Onay sonrası başlık otomatik bu listeye düşer.

Hata yanıtları

401 — Üyelik bilgileri hatalı

API Anahtar/Hash doğrulanamadı veya panel toggle kapalı. Detay: authentication.md.

Diğer hata kodları

400, 404 için tablo: error-codes.md.

Kod örnekleri

cURL

curl -X POST 'https://api.iletimerkezi.com/v1/get-sender/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "request": {
      "authentication": {
        "key": "'"$ILETIMERKEZI_API_KEY"'",
        "hash": "'"$ILETIMERKEZI_API_HASH"'"
      }
    }
  }'

Common Pitfalls

Boş liste = onay süreci tamamlanmamış. Yeni hesaplarda senders.sender boş bir dizi ([]) olarak gelir. Başlık başvurusu panelden yapılır, iletiMerkezi tarafından 1-2 iş günü içinde değerlendirilir. Onay beklerken send-sms'te sender değerini "APITEST" olarak göndererek HTTP akışını test edebilirsiniz; detay: test-mode.
send-sms öncesi runtime kontrol önerilir. Production akışlarda order.sender değerinin bu listede olup olmadığını koddan kontrol edin; "yanlış başlık" hatası canlıda mesaj patlaması yaratır.
Başlık 11 karakter sınırı. Maksimum 11 karakter, alfanumerik. Boşluk hesaba katılır (eMarka Test = 11 karakter).
Liste sıkça değişmez. Onay süreci nadirdir; her send-sms öncesi get-sender çağırmak gereksizdir. Liste application start'ta veya panel-event tabanlı yenilemelerde çekilebilir.
Sender ID büyük/küçük harf duyarlıdır. Panel'de eMarka Test olarak onaylandıysa send-sms isteğinde de aynen yazın (emarka test veya EMARKA TEST reddedilebilir).

Son güncelleme: 2026-04-29 · English version