Verificar a cobertura da tabela de atribuição
Verifique se um número norte-americano corresponde a um prefixo na tabela de atribuição da MultiTEL e obtenha a cidade, o estado e o país associados. Esta é uma consulta a uma tabela de prefixos. Não comprova que um assinante esteja ativo, que um número esteja atribuído, que pertença à sua conta ou que possa ser encomendado.
Pedido
Utilize a sua conta de API habilitada e um endereço IP de origem autorizado. O exemplo utiliza credenciais de HTTP Basic obtidas de variáveis de ambiente e um número fictício. Não é necessário enviar um corpo no pedido.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Utilize de preferência um número norte-americano de onze dígitos que comece por 1. O processamento remove os caracteres que não sejam dígitos e acrescenta 1 no início de uma entrada de dez dígitos. Outras quantidades de dígitos são rejeitadas. Esta normalização não verifica todas as regras de numeração norte-americanas, pelo que uma correspondência encontrada na tabela não constitui uma validação exaustiva do número.
Resposta
Os valores dos campos são meramente ilustrativos; este não é um resultado de uma consulta à tabela de atribuição em produção.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Campo | Significado |
|---|---|
| number | Entrada normalizada, composta apenas por dígitos. |
| npanxx | O prefixo armazenado que corresponde à entrada. O processamento dá preferência a um prefixo de sete dígitos de país/área/central telefónica e pode recorrer a um prefixo de quatro dígitos de país/área; não presuma que este campo identifica sempre uma central telefónica completa. |
| city, state, country | Metadados do prefixo de atribuição correspondente. Estes campos não identificam a localização física atual de um assinante nem a sua operadora atual após a portabilidade. |
Erros
Leia o campo status.code no JSON, em vez de confiar apenas no código HTTP 200. O código de API 404 com a mensagem Not part of NANPA significa que nenhum prefixo correspondeu à tabela utilizada pelo serviço; não constitui uma determinação definitiva de uma autoridade de numeração de âmbito mundial. O código de API 500 é utilizado quando a quantidade de dígitos é inválida ou o número está em falta.
Custo e próximos passos
A implementação de processamento revista consulta uma tabela de atribuição local e não efetua qualquer débito na conta nem consulta externa. Este processamento não aplica qualquer taxa de consulta. Utilize a pesquisa de números disponíveis para encontrar números em stock que possam ser encomendados. Uma consulta de nome, uma consulta de encaminhamento ou uma encomenda de número é uma operação distinta, com os seus próprios preços aplicáveis à conta.