Ana içeriğe geç

Kara listeden numara silme

DELETE 

/blacklist

İstek: DELETE https://ext-sandbox.netgsm.com.tr/sms/v3/blacklist
Sandbox: https://ext-sandbox.netgsm.com.tr/sms/v3

Hesabın kara listesinden numara siler. Silinen numara hesabın mesajlarını yeniden alır. Bir istekte en fazla 100 numara gönderilebilir. Numaralar, tıpkı eklemede olduğu gibi, istek gövdesinde gönderilir.

Numara biçimi. 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 silinmez.

Listede olmayan numaralar. En az bir numara silindiyse yanıt 200'dür; istenen her numara removedNumbers ya da notFoundNumbers listelerinden birinde yer alır (1 numara silinip 99'u listede değilse yanıt yine 200'dür). Hiçbir numara silinmediyse, yani istenen numaraların hiçbiri listede değilse, yanıt 404 olur.

Silme geri alınamaz. Numara listeden kalıcı olarak kaldırılır; alıcının kendi isteğiyle listeye girmiş bir numara da silinebilir. Numarayı yeniden engellemek için ekleme isteği gönderin.

İstek sınırı. Hesap başına dakikada 30 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 silinen numaralar ikinci istekte notFoundNumbers içinde döner ya da hepsi silinmişse yanıt 404 olur.

Request​

Bodyrequired

    numbersstring[]required

    Kara listeden silinecek 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 silinir.

    Possible values: >= 1, <= 100

Responses​

En az bir numara silindi; silinenler ve listede olmayanlar ayrı ayrı döner.

Schema
    removedintegerrequired

    Silinen numara sayısı; en az 1.

    Possible values: >= 1

    notFoundintegerrequired

    Kara listede olmadığı için silinmeyen numara sayısı.

    removedNumbersstring[]required

    Silinen numaralar, E.164 biçiminde.

    Possible values: <= 100

    notFoundNumbersstring[]required

    Kara listede olmayan numaralar, E.164 biçiminde.

    Possible values: <= 100

Örnek istek​

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