Czarna lista

Wyświetlaj, dodawaj i usuwaj zablokowane numery. Połączenie z numeru na czarnej liście jest odrzucane, zanim dotrze do centrali; zmiana obowiązuje natychmiast. Klucz centrali (key=K…). Limit zapytań: 10 na minutę.

GETCzarna lista

GET https://api.buluthat.com/api/blocked_numbers.php?key=K…&limit=50&page=1
{
  "blocked_numbers": [
    { "id": 4274, "number": "05531234567" },
    { "id": 4301, "number": "02120000000" }
  ],
  "pagination": { "page": 1, "total_count": 2, "total_pages": 1, "limit": 50 }
}
ParametrOpis
limitRozmiar strony; 10-100, domyślnie 10
pageNumer strony, domyślnie 1

POSTDodaj do czarnej listy

POST https://api.buluthat.com/api/blocked_numbers.php
Content-Type: application/json

{ "key": "K…", "number": "05531234567" }

Odpowiedź 200 OK, w treści identyfikator rekordu (20212). Jeśli ten sam numer zostanie dodany ponownie, zwracany jest istniejący identyfikator.

Błędy: 400 number required, 400 number invalid.

GETUsuń z czarnej listy

GET https://api.buluthat.com/api/blocked_numbers_delete.php?key=K…&number=05531234567

Akceptowana jest także postać ścieżki: /api/blocked_numbers/delete/?key=K…&number=…. Odpowiedź 200 OK.

Blokada numerów ukrytych

Dzwoniący z ukrytym numerem (puste CallerID, „anonymous”, flaga prywatności) nie trafiają na listę jako numer; blokadę włącza się przełącznikiem w panelu > Blokada numerów > „Blokuj numery ukryte”. Ponieważ operatorzy przenoszą ukryte połączenia na trzy różne sposoby, sprawdzane są wszystkie trzy naraz.