Consultar informações de roteamento
Solicite informações de roteamento de um número de telefone da América do Norte. Use essas informações para interpretar os dados disponíveis de roteamento e da operadora, não como prova da identidade do assinante, da titularidade do número, da possibilidade de contatá-lo ou da disponibilidade do número para compra. Uma consulta pode gerar uma cobrança na sua conta.
Solicitação
Use sua conta de API habilitada e o endereço IP de origem permitido para ela. Forneça o número completo em dígitos, incluindo o código de país 1. O exemplo usa variáveis de ambiente e um número fictício. O componente que processa a solicitação não normaliza a pontuação; valide os dados de entrada antes de enviá-los.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/lrn/12025550123Resposta
Apenas uma seleção de campos para ilustração; a disponibilidade depende da fonte e do tipo de número.
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ocn": "0000",
"local": 1,
"ported": 0,
"cost": "$0.00025"
}
}A consulta padrão converte os nomes dos campos retornados em letras minúsculas. Dependendo da fonte, podem estar presentes campos de operadora, centro de tarifação, localização e jurisdição. A resposta não é um cadastro completo do assinante com estrutura fixa. O indicador local pode ter o valor numérico 1 ou o valor de texto 0. O componente que processa a solicitação calcula ported comparando o número de roteamento retornado com o número de telefone fornecido; não o interprete como um histórico completo e verificado de portabilidade.
Preço e novas tentativas
O componente revisado que processa a solicitação aplica um débito de $0.00025 à conta quando chega ao seu caminho de conclusão e registra a consulta. O custo retornado normalmente é uma cadeia de texto que inclui o símbolo de dólar, em vez de um valor puramente numérico. Nenhuma chave de idempotência é disponibilizada. Repetir uma solicitação pode gerar outra cobrança.
Para contas pré-pagas, o código verifica se há um saldo de pelo menos 0.00025. A mensagem de saldo insuficiente atualmente menciona $5, o que não corresponde a esse limite. Interprete a falha como uma rejeição por saldo e confirme os fundos da conta antes de tentar novamente.
Falhas e resultados bem-sucedidos incompletos
Consulte tanto o status HTTP quanto os campos status.code/status.msg do JSON. Um resultado vazio de uma consulta padrão retorna o código 404 da API. O código 403 da API pode indicar saldo pré-pago insuficiente.
Um dos caminhos de erro atuais para números de chamada gratuita ainda pode debitar o valor da consulta e informar o código 200 da API sem campos úteis de roteamento; as informações sobre seu custo podem estar incompletas. Portanto, um código 200 por si só não comprova que a consulta seja utilizável. Valide os campos necessários para sua aplicação, confira as cobranças duvidosas nos registros de faturamento da conta e entre em contato com o suporte em caso de resultados incompletos.
Na implementação revisada, o tratamento de números de chamada gratuita varia conforme o comprimento dos dados de entrada. Prefira todos os dígitos do número em formato internacional e confirme com o suporte a cobertura necessária para números de chamada gratuita. Não repita automaticamente uma consulta cujo resultado esteja malformado ou incompleto, nem se baseie em uma consulta de roteamento para decidir que é seguro ligar para um número ou que há autorização para fazer a chamada.