Lista numerów czarnej listy
/v1/accounts/{accountId}/blackLists/{blackListId}/numbersZwraca numery czarnej listy, opcjonalnie przefiltrowane i posortowane.
Parametry ścieżki
ID Twojego konta SIP Caller. Zobacz ID konta.
ID czarnej listy.
Parametry zapytania
Warunki, które muszą spełniać rekordy, na przykład {"name":"sales"}. Zobacz Pola filtra poniżej oraz Filtrowanie, aby poznać składnię.
Pole i kierunek sortowania rekordów, na przykład ["number","DESC"]. Domyślnie ["number","ASC"]. Zobacz Sortowanie.
Liczone od zera pozycje pierwszego i ostatniego zwracanego rekordu, obie włącznie, na przykład [0,99]. Domyślnie [0,9]. Zobacz Paginacja.
Pola filtra
Pola, których można używać w parametrze zapytania filter. Ogólną składnię opisano w sekcji Filtrowanie.
Numery zawierające podany tekst, co umożliwia częściowe wyszukiwanie.
{"number":"555010"}Pola sortowania
Pola, których można używać w parametrze zapytania sort, w kolejności rosnącej (ASC) lub malejącej (DESC). Ogólną składnię opisano w sekcji Sortowanie. Gdy parametr sort zostanie pominięty, wyniki są sortowane rosnąco według pola number.
numberidZwraca
Zwraca tablicę obiektów numeru czarnej listy dla żądanej strony. Nagłówki X-Total-Count i Content-Range zawierają całkowitą liczbę rekordów pasujących do filtra, na przykład Content-Range: blackListNumbers 0-9/57. Zobacz Paginacja.
/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"number":"555010"}' \
--data-urlencode 'sort=["number","DESC"]' \
--data-urlencode 'range=[0,99]'Odpowiedź
200 OK
[
{
"id": 3,
"number": "+18005550103",
"description": "Asked not to be called again"
},
{
"id": 2,
"number": "+18005550102",
"description": null
},
{
"id": 1,
"number": "+18005550101",
"description": "Customer request, 2026-09-12"
}
]
