Ana içeriğe geç

Kara listeye numara ekleme

POST 

/blacklist

İstek: POST https://ext-api.netgsm.com.tr/sms/v3/blacklist
Canlı ortam: https://ext-api.netgsm.com.tr/sms/v3

Hesabın kara listesine numara ekler. Bir istekte en fazla 100 numara gönderilebilir.

Numara biçimi. Kara liste yalnızca yurt içi numara tutar. Her numara E.164 biçiminde, +90 ve on rakam olarak yazılır (+905XXXXXXXXX). Artısız yazımlar (905XXXXXXXXX, 5XXXXXXXXX) ve başka ülke kodlu numaralar kabul edilmez. Numaralardan biri bile kurala uymuyorsa istek bütünüyle 400 ile reddedilir ve hiçbir numara eklenmez.

Zaten listede olan numaralar. Kara listede olan bir numara ikinci kez eklenmez. En az bir numara eklendiyse yanıt 200'dür; istenen her numara addedNumbers ya da existingNumbers listelerinden birinde yer alır (1 numara eklenip 99'u zaten listedeyse yanıt yine 200'dür). Hiçbir numara eklenmediyse, yani istenen numaraların hepsi zaten listedeyse, yanıt 409 olur.

İstek sınırı. Hesap başına dakikada 60 istek. Süre penceresi ilk istekle başlar ve sabittir. Aşıldığında 429 Retry-After başlığıyla döner.

Yeniden deneme. İsteği yeniden göndermek her zaman güvenlidir: ilk istekte eklenen numaralar ikinci kez eklenmez; ikinci istekte existingNumbers içinde döner ya da hepsi eklenmişse yanıt 409 olur.

Request​

Bodyrequired

    numbersstring[]required

    Kara listeye eklenecek numaralar; en az 1, en fazla 100. Her biri E.164 biçiminde ve yurt içi, +90 ve on rakam. Aynı numara birden fazla yazılırsa bir kez eklenir.

    Possible values: >= 1, <= 100

Responses​

En az bir numara eklendi; eklenenler ve zaten listede olanlar ayrı ayrı döner.

Schema
    addedintegerrequired

    Eklenen numara sayısı; en az 1.

    Possible values: >= 1

    existingintegerrequired

    Zaten kara listede olduğu için eklenmeyen numara sayısı.

    addedNumbersstring[]required

    Eklenen numaralar, E.164 biçiminde.

    Possible values: <= 100

    existingNumbersstring[]required

    Zaten kara listede olan numaralar, E.164 biçiminde.

    Possible values: <= 100

Örnek istek​

curl -X POST 'https://ext-api.netgsm.com.tr/sms/v3/blacklist' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"numbers": [
"+905XXXXXXXXX",
"+905yyyyyyyyy"
]
}'