Um só fluxo, no painel e na API
Teste as verificações no painel e depois conecte seu servidor às mesmas verificações avulsas e em lote pela API.
Comece com uma verificação avulsa
Envie as requisições para https://api.numdetect.com com uma chave de API guardada no seu servidor. Você pode criar várias chaves no painel, uma por sistema, e excluir qualquer uma delas. Não coloque uma chave no código do frontend.
curl "https://api.numdetect.com/api/v1/checks" \
-H "Authorization: Bearer $NUMDETECT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"phone": "+12025550147",
"products": [
"whatsapp"
]
}'Requisição ilustrativa com um número de amostra. Substitua $NUMDETECT_API_KEY pela sua chave; cada execução é uma verificação real e é cobrada.
O que uma verificação retorna
Cada entrada recebe um registro por produto. Leia registered primeiro: true e false são conclusivos, null é desconhecido. Uma verificação avulsa só cobra true e false; um grupo em lote é cobrado integralmente quando o lote termina.
{
"id": "10000000-0000-4000-8000-000000000001",
"input_kind": "phone",
"input": "+12025550147",
"country": "US",
"charged": 4000,
"results": [
{
"product_id": "whatsapp",
"status": "success",
"result": true,
"price": 4000,
"charged": 4000
}
]
}status- success: uma resposta definitiva; unknown: sem resposta conclusiva; failed: não foi possível acessar o produto. Só success é cobrado.
result- true: uma conta foi encontrada; false: sem conta; null quando status não é success.
info- Campos extras que alguns produtos retornam, como o sinal de WhatsApp Business.
price- O preço deste produto para a verificação, em USD micros (1.000.000 = US$ 1).
charged- O que foi realmente cobrado: o preço quando a resposta é definitiva; caso contrário, 0.
01
Explore no painel
Faça algumas verificações avulsas no painel para ver as entradas e as respostas antes de escrever sua integração.
02
Consulte o catálogo atual
Consulte a lista de produtos para ver quais estão à venda, seus tipos de entrada, países e preços. Não os fixe no código a partir do site público.
03
Crie e acompanhe uma tarefa
Envie um Idempotency-Key ao criar uma verificação ou uma tarefa em lote. Se uma resposta se perder, tente de novo com a mesma chave em vez de uma nova.
Fluxo de telefones em lote
- 1
Envie o arquivo CSV ou de texto com os produtos, a coluna dos números e o máximo que você aceita pagar.
- 2
A lista é dividida por país; cada país é verificado por cada produto que você escolheu.
- 3
Acompanhe a tarefa até terminar, ou receba um webhook.
- 4
Baixe um único arquivo de resultados com todas as linhas originais e uma coluna de resposta por produto.
Mantenha as chaves no seu servidor
- Até 10 chaves de API Bearer por conta, cada uma podendo ser excluída a qualquer momento.
- Um webhook assinado é enviado quando uma tarefa em lote termina.
- Os arquivos de resultados são baixados por um link válido por 10 minutos.
Use variáveis de ambiente para as credenciais e exclua uma chave no painel se ela for exposta. Inclua os IDs da verificação ou da tarefa ao pedir suporte; nunca cole chaves de API em capturas de tela ou exemplos públicos.
Pronto para verificar seus números?
Comece logo após o cadastro, sem aprovação prévia. Recarregue seu saldo e verifique números reais.