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

Переглядайте, додавайте, видаляйте заблоковані номери. Дзвінок із номера з чорного списку відхиляється, не потрапляючи на АТС; зміна діє миттєво. Ключ АТС (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 }
}
ПараметрОпис
limitРозмір сторінки; 10-100, за замовчуванням 10
pageНомер сторінки, за замовчуванням 1

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», прапорець приватності), не потрапляють у список як номер; це блокування вмикається перемикачем у панелі > Блокування номерів > «Блокувати приховані номери». Оскільки оператори передають прихований дзвінок трьома різними способами, перевіряються всі три.