Detalhes técnicos da Number Insight API
A Number Insight API da Vonage fornece informações em tempo real sobre números de telefone, ajudando você a entender com quem está se comunicando. Verifique instantaneamente se um número é de celular ou de telefone fixo, identifique a operadora associada a números de celular, verifique se o número está no formato correto e detecte possíveis sinais de fraude.
A partir de 4 de fevereiro de 2027, a Vonage encerrará o serviço Vonage Number Insights. Para garantir um suporte ininterrupto e oferecer uma solução mais escalável e preparada para o futuro, recomendamos que você migre para nossa oferta aprimorada: API do Vonage Identity Insights. A Number Insight API consolida vários conjuntos de dados relacionados a números de telefone em uma única API flexível, permitindo que você solicite informações em tempo real sobre um número de telefone e obtenha qualquer combinação de informações — como formatação do número, detalhes da operadora, troca de SIM e correspondência de assinante — em uma única chamada.
Por favor, verifique o Guia de Transição do Numbers Insights, que oferece orientações detalhadas sobre as diferenças nas APIs, as alterações necessárias e as melhores práticas para uma transição tranquila.
Recursos do Number Insight
Os recursos da Number Insight API estão distribuídos por vários planos ou pontos de conexão, dependendo do tipo de informação de que você precisa.
As informações sobre a operadora estão disponíveis nos planos Básico, Padrão e Avançado, sendo que cada endpoint amplia os recursos do anterior. Por exemplo, o endpoint Padrão inclui todos os dados de localidade e formatação do endpoint Básico, além de detalhes adicionais, como o tipo de número, a operadora atual (se for um número de celular) e a identidade do chamador (apenas nos EUA). O endpoint Avançado oferece os dados mais abrangentes, incluindo tudo o que está presente nos endpoints Básico e Padrão, além de informações sobre roaming e acessibilidade.
O Plano de Detecção de Fraudes (BETA), por outro lado, combina métricas dos planos mencionados acima com fontes de dados adicionais para avaliar se um número é provavelmente fraudulento, como nos casos de trocas recentes de cartões SIM.
Comparação de recursos
| Destaque | Básico | Padrão | Avançado |
|---|---|---|---|
| Formato e origem dos números | |||
| Informações sobre o país (código do país, nome, prefixo) | |||
| Operadora atual (código da rede, nome, país, tipo de rede) | |||
| Operadora original (código da rede, nome, país, tipo de rede) | |||
| Informações sobre portabilidade | |||
| Validade* | |||
| Acessibilidade* | |||
| Status de roaming* | |||
| Operadora de roaming e país* | |||
| CNAM (complemento) |
* Disponível apenas em determinados mercados. Faça um teste e/ou entre em contato com o departamento de vendas para obter mais informações.
Verifique a legislação do seu país para garantir que você está autorizado a armazenar informações de roaming dos usuários.
Introdução
Este exemplo mostra como usar o CLI da Vonage para acessar a Number Insight API Basic e exibir informações sobre um número.
Para ver exemplos de como usar o Number Insight Básico, Padrão e Avançado com curl e os SDKs para desenvolvedores, consulte o Trechos de código.
Antes de começar:
- Inscreva-se para um Account da API da Vonage
- Instalar Node.JS
Instale e configure o CLI da Vonage
$ npm install --location=global @vonage/cli
Observação: Dependendo das suas permissões de usuário, talvez seja necessário antepor ao comando acima sudo.
Use seu VONAGE_API_KEY e VONAGE_API_SECRET do página de introdução do painel de controle Para configurar o CLI da Vonage com suas credenciais:
Executar uma consulta básica na Number Insight API
Execute o comando de exemplo mostrado abaixo, substituindo o número de telefone pelo número sobre o qual você deseja obter informações: