Ana içeriğe geç

Numara Engelle API (add-blacklist)

add-blacklist endpoint'i, SMS gönderilmesini istemediğiniz bir cep telefonu numarasını hesabınızın kara listesine ekler. Bu listedeki numaralara send-sms çağrılarında mesaj iletilmez. Idempotent: aynı numarayı ikinci kez eklemek hata değil, 200 döndürür. İstek başına yalnızca bir numara eklenir.

Ö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/add-blacklist/json | | Content-Type | application/json | | Auth | API Key + Hash (request.authentication) |

Request

Şema

request
├─ authentication
│  ├─ key (string, zorunlu)
│  └─ hash (string, zorunlu)
└─ blacklist
   └─ number (string, zorunlu) — tek numara, 905XXXXXXXXX / +905XXXXXXXXX / 5XXXXXXXXX

Tam örnek

{
  "request": {
    "authentication": {
      "key": "API_KEY",
      "hash": "API_HASH"
    },
    "blacklist": {
      "number": "905XXXXXXXXX"
    }
  }
}

Response

Başarılı (200)

{
  "response": {
    "status": {
      "code": 200,
      "message": "İşlem başarılı"
    }
  }
}

Numara hesaba ait kara listeye eklendi. Aynı numarayı ikinci kez eklemek de aynı 200 yanıtını döndürür.

Hata yanıtları

401 — Üyelik bilgileri hatalı

Detay: authentication.md.

466 — Hatalı numara

Numara format olarak Türkiye operatör prefix'lerine uymuyor (50/53/54/55 vb.). +905330000099 gibi geçerli bir numara verin. Test sırasında uyduruk prefix (905999XXXXXXX gibi) reddedilir.

Diğer hata kodları

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

Kod örnekleri

cURL

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

Common Pitfalls

  • Idempotent davranış. Aynı numarayı tekrar eklemek hata değildir, 200 döner. try/except 466 gibi guard'a gerek yok; "zaten engellenmiş mi?" diye get-blacklist ile ön kontrol gereksiz.
  • Tek numara, istek başına. blacklist.number dizi değildir — tek string. Toplu engelleme için her numara için ayrı istek atın (rate limit'e dikkat).
  • 466 = geçersiz Türkiye operatör prefix'i. +905330000099 çalışır, +905999000000 reddedilir. Yabancı numaralar (örn. +49...) MDX'te örnek var; canlı kabul davranışı operatör tarafına bağlıdır, kritik akışta kendi sisteminizden test edin.
  • Numara format esnek, dönüş +90 prefix'li. 905..., +905..., 5... kabul edilir; get-blacklist yanıtında numara +905XXXXXXXXX olarak döner.

Related

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