---
title: "Gelen SMS API (get-inbox)"
description: "Hesabınıza gelen SMS mesajlarını listeleyin. Tarih, gönderici, içerik ve hesap numarası bilgisini tek yanıtta alın."
slug: /docs/api/inbox
locale: tr
audience: developer
last_updated: 2026-04-29
endpoint:
  method: POST
  path: /v1/get-inbox/json
  base_url: https://api.iletimerkezi.com
auth: api-key-and-hash
related: [send-sms, authentication, error-codes]
alternates:
  tr: https://www.iletimerkezi.com/docs/api/inbox
  en: https://www.iletimerkezi.com/en/docs/api/inbox
---

# Gelen SMS API (get-inbox)

`get-inbox` endpoint'i, iletiMerkezi hesabınıza gelen SMS mesajlarını listeler. Hesabınızdaki numaralara dış dünyadan gönderilen mesajlar (genellikle abonelik iptal anahtar kelimeleri "RET", müşteri yanıtları, kısa kod gönderimleri) bu endpoint üzerinden okunur. Yan etkisiz, kontör harcamaz.

## Tipik kullanım

iletiMerkezi'nin **4 haneli kısa kod servisi** ile müşterilerden gelen mesajları toplarsınız. Tipik akışlar:

- **Otomatik çıkış (opt-out):** "ABC RET yaz 7889'a gönder" gibi anahtar kelimeler. Müşteri "RET" mesajı gönderdiğinde panel tarafı otomatik olarak kara listeye ekler. Ham mesaj `get-inbox` ile de okunabilir, audit veya CRM senkronizasyonu için.
- **Anket / cevap toplama:** "ABC ANKET A" gibi sektörel kısa kod akışlarıyla müşteri yanıtlarını uygulamanıza taşımak.
- **Rezervasyon / bilgi talebi:** Müşteriden tetiklenen self-service akışlar.
- **iim.to kısa link entegrasyonu:** Mesaj sonuna iliştirilen kısaltılmış çıkış linkine tıklayan kullanıcılar otomatik kara listeye düşer; bu akış panelde konfigüre edilir, ek API çağrısı gerekmez.

Kısa kod hizmeti firma ihtiyaçlarına göre projelendirilir; başvuru ve aktivasyon süreci `panel.iletimerkezi.com` üzerinden yapılır.

## Ö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](./authentication.md).

## Endpoint

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

## Request

### Şema

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

`get-inbox` ek alan beklemez; sadece auth bloğu gönderilir.

### 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ı"
    },
    "orders": {
      "totalRows": "5",
      "order": [
        {
          "id": "5",
          "date": "2026-04-09 11:18:44",
          "sender": "7889",
          "number": "+905354104818",
          "text": "ILT AHKTEST RET"
        }
      ]
    }
  }
}
```

**Alanlar:**

- `response.orders.totalRows` (string): Hesaba ait toplam gelen mesaj sayısı.
- `response.orders.order[]` (array): Mesaj listesi.
  - `id` (string): Gelen mesajın eşsiz ID'si.
  - `date` (string): Geliş zamanı, format `YYYY-MM-DD HH:MM:SS`.
  - `sender` (string): Mesajı gönderen taraf (cep numarası ya da operatör kısa kodu).
  - `number` (string): Mesajın geldiği hesap numaranız, `+90` prefix'i ile.
  - `text` (string): Mesaj içeriği.

> Bu endpoint apidocs-website'ın eski şartnamesinde yer almıyor; canlı API'yi ground truth alıyoruz (drift: [`apidocs-website#4`](https://github.com/iletimerkezi/apidocs-website/issues/4)). Yanıt yapısı 2026-04-29 itibarıyla canlı testle doğrulandı.

### Hata yanıtları

#### 401 — Üyelik bilgileri hatalı

Detay: [authentication](./authentication.md).

#### Diğer hata kodları

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

## Kod örnekleri

### cURL

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

## Common Pitfalls

- **`totalRows` string'tir, integer değil.** Yanıt `"totalRows": "5"` şeklinde gelir; sayısal işlem yapacaksanız `parseInt`/`Number` ile çevirin.
- **`sender` her zaman cep numarası değil.** Operatör kısa kodları (örn. `7889`) ya da alfanumerik gönderici adları da gelebilir; format kontrolü esnek olmalı.
- **`text` operator-yönlendirmeli olabilir.** "RET" gibi abonelik iptal anahtar kelimeleri operatör tarafında otomatik formatlanır; içerik "ILT AHKTEST RET" gibi prefix'lenmiş gelebilir. İş kuralında trim + lowercase normalizasyonu önerilir.
- **Sayfalama dokümante edilmemiş.** `totalRows` 1000'i geçerse istemcide tüm liste tek seferde gelmiyor olabilir; `page` / `rowCount` parametrelerinin kabul edilip edilmediği yayın öncesi denenmelidir.
- **`get-inbox` kontör harcamaz.** Polling güvenli; ama webhook varsa pollingten kaçının, bant kullanmaz.

## Related

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