Engellenmiş Numara Listesi API (get-blacklist)

get-blacklist endpoint'i, hesabınızdaki kara listeye eklenmiş numaraları döner. Mesaj göndermek istemediğiniz numaralar bu listeye eklenir; send-sms çağrılarında bu listedeki numaralara mesaj iletimi atlanır. Yan etkisiz, 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-blacklist/json | | Content-Type | application/json | | Auth | API Key + Hash (request.authentication) |

Request

Şema

request
├─ authentication
│  ├─ key (string, zorunlu)
│  └─ hash (string, zorunlu)
└─ blacklist (opsiyonel — sayfalama ve filtre)
   ├─ filter (opsiyonel)
   │  ├─ start (string)    — "YYYY-MM-DD HH:MM:SS"
   │  └─ end (string)      — "YYYY-MM-DD HH:MM:SS"
   ├─ page (string)        — varsayılan "1"
   └─ rowCount (string)    — varsayılan "1000", maks "1000"

Tam örnek

Filtresiz, ilk sayfa:

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

Tarih filtresiyle:

{
  "request": {
    "authentication": {
      "key": "API_KEY",
      "hash": "API_HASH"
    },
    "blacklist": {
      "filter": {
        "start": "2026-04-01 00:00:00",
        "end": "2026-04-30 23:59:59"
      },
      "page": "1",
      "rowCount": "100"
    }
  }
}

Response

Başarılı (200)

{
  "response": {
    "status": {
      "code": 200,
      "message": "İşlem başarılı"
    },
    "blacklist": {
      "count": 1,
      "number": [
        "+905330000099"
      ]
    }
  }
}

Alanlar:

response.blacklist.count (integer): Hesaptaki toplam engellenmiş numara sayısı (sayfalamadan bağımsız, genel toplam).
response.blacklist.number (string[]): Bu sayfadaki engellenmiş numaralar. Yanıtta numaralar +90 prefix'i ile gelir (gönderirken 905XXXXXXXXX ya da +905XXXXXXXXX ikisi de kabul edilir).

Boş liste (200)

{
  "response": {
    "status": { "code": 200, "message": "İşlem başarılı" },
    "blacklist": { "count": 0, "number": [] }
  }
}

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-blacklist/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "request": {
      "authentication": {
        "key": "'"$ILETIMERKEZI_API_KEY"'",
        "hash": "'"$ILETIMERKEZI_API_HASH"'"
      }
    }
  }'

Common Pitfalls

Numara format dönüşte değişir. Eklerken 905XXXXXXXXX versen bile yanıt +905XXXXXXXXX döner. Karşılaştırma yapan kodlarda iki formatı da normalize edin.
Sayfalama 1000'le sınırlı. rowCount üst sınır 1000. 1000'den fazla kayıt için page arttırarak ardışık çağrı yapın; toplam adedi count alanı verir.
count sayfalamadan bağımsız. Sayfada kaç kayıt görüldüğüne bakmaksızın hesaptaki toplam engellenmiş numarayı verir; pagination loop kontrolü için bu kullanılır.
get-blacklist kontör harcamaz. Cache'lemek pratik bir kullanım deseni; her send-sms öncesi çağırmaya gerek yok.

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