Чёрный список

Просматривайте, добавляйте и удаляйте заблокированные номера. Вызов с номера из чёрного списка отклоняется ещё до поступления на АТС; изменение действует мгновенно. Ключ АТС (key=K…). Лимит запросов: 10 в минуту.

GETЧёрный список

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 }
}

POSTДобавить в чёрный список

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

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

Ответ 200 OK, в теле — id записи (20212). При повторном добавлении того же номера возвращается существующий id.

Ошибки: 400 number required, 400 number invalid.

GETУдалить из чёрного списка

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

Принимается и формат пути: /api/blocked_numbers/delete/?key=K…&number=…. Ответ 200 OK.

Блокировка скрытого номера

Звонящие со скрытым номером (пустой CallerID, «anonymous», флаг конфиденциальности) в список как номер не попадают; эта блокировка включается переключателем в панели: Блокировка номеров > «Блокировать скрытые номера». Поскольку операторы передают скрытый вызов тремя разными способами, проверяются все три.