Ana içeriğe geç

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.

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

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

Response

Başarılı (200)

{
  "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). Yanıt yapısı 2026-04-29 itibarıyla canlı testle doğrulandı.

Hata yanıtları

401 — Üyelik bilgileri hatalı

Detay: authentication.

Diğer hata kodları

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

Kod örnekleri

cURL

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

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