黑名单

列出、添加、删除被屏蔽号码。黑名单中的号码来电会在到达总机前被拒绝；变更立即生效。 总机密钥 (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”、隐私标志）不会作为号码进入列表；此拦截通过面板 > 号码拦截 >“拦截隐藏号码”开关开启。由于运营商以三种不同方式传递隐藏来电，三种情况会同时检查。