---
title: "Onaylı Başlık Listesi API (get-sender)"
description: "Hesabınızda tanımlanmış ve iletiMerkezi tarafından onaylanmış sender ID (başlık) listesini alın. send-sms öncesi başlık doğrulaması için ideal."
slug: /docs/api/get-sender
locale: tr
audience: developer
last_updated: 2026-04-29
endpoint:
  method: POST
  path: /v1/get-sender/json
  base_url: https://api.iletimerkezi.com
auth: api-key-and-hash
related: [authentication, send-sms, error-codes]
alternates:
  tr: https://www.iletimerkezi.com/docs/api/get-sender
  en: https://www.iletimerkezi.com/en/docs/api/get-sender
  toplusmsapi: https://toplusmsapi.com/sms/baslik/liste/json
  a2psmsapi: https://a2psmsapi.com/en/sms/baslik/liste/json
---

# 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](./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

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

## Response

### Başarılı (200)

```json
{
  "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](./authentication.md).

#### Diğer hata kodları

`400, 404` için tablo: [error-codes.md](./error-codes.md).

## Kod örnekleri

### cURL

```bash
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](./test-mode.md).
- **`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).


## Related

- [Kimlik doğrulama (authentication)](./authentication.md)
- [SMS gönderme (send-sms)](./send-sms.md)
- [Bakiye sorgulama (get-balance)](./get-balance.md)
- [Hata kodları tablosu](./error-codes.md)