Lista negra

Liste, adicione e elimine números bloqueados. A chamada de um número em lista negra é recusada antes de chegar à central; a alteração é imediata. Chave da central (key=K…). Limite de pedidos: 10 por minuto.

GETLista negra

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 }
}
ParâmetroDescrição
limitTamanho da página; 10-100, por defeito 10
pageNúmero da página, por defeito 1

POSTAdicionar à lista negra

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

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

Resposta 200 OK, no corpo o id do registo (20212). Se o mesmo número for adicionado uma segunda vez, é devolvido o id existente.

Erros: 400 number required, 400 number invalid.

GETEliminar da lista negra

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

O formato de caminho também é aceite: /api/blocked_numbers/delete/?key=K…&number=…. Resposta 200 OK.

Bloqueio de número oculto

Quem liga ocultando o número (CallerID vazio, "anonymous", indicador de privacidade) não entra na lista como número; este bloqueio ativa-se com o interruptor painel > Bloqueio de Números > "Bloquear números ocultos". Como os operadores transportam a chamada oculta de três formas diferentes, as três são verificadas em conjunto.