· 2 min read
API de detalhes do verificador em massa de números WhatsApp
Verifique se um número global está no WhatsApp e obtenha informações detalhadas do perfil, incluindo assinaturas e atualizações de estado.
Verifique se um número global é uma conta WhatsApp registada e obtenha informações detalhadas do perfil.
URL da API
POST https://api.checknumber.ai/v1/tasks
Características principais
A API de detalhes do verificador em massa oferece capacidades completas de verificação:
Informação da conta
Informação detalhada da conta WhatsApp: verificação de estado, assinaturas do utilizador e marcas temporais de atualização de estado.
Processamento em massa
Processe vários números em simultâneo através do carregamento de ficheiro, eficiente para verificações em grande escala.
Atualizações de estado em tempo real
Acompanhe o progresso das suas tarefas de verificação em massa em tempo real.
Passos de utilização
Carregamento de ficheiro
Carregue um ficheiro de texto com números em formato E.164.
Exemplo de pedido
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file"' \
--form 'task_type="ws_active"'
Parâmetros do pedido
| Parâmetro | Tipo | Descrição |
|---|---|---|
file | file | Ficheiro com números a verificar, um número por linha |
task_type | string | ws_active — atividade / assinatura |
Verificação de estado
Consulte o estado de processamento da sua tarefa:
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
Exemplos de resposta
A API devolve objetos JSON com created_at, updated_at, task_id, status, total, success, failure e, quando o estado é “exported”, result_url.
Campos do resultado
| Campo | Descrição |
|---|---|
Number | Número em formato E.164 |
signature | Assinatura do estado WhatsApp |
status_update | Hora da última atualização de estado |
whatsapp | Se o número tem conta WhatsApp ativa |
Códigos de estado
| Estado | Descrição |
|---|---|
200 | Pedido com sucesso, tarefa criada ou estado obtido (pago) |
400 | Pedido inválido, parâmetros ou formato inválidos (grátis) |
500 | Erro interno do servidor, tente mais tarde (grátis) |
Notas de integração
- Cada linha do ficheiro deve conter um número em formato E.164.
- Consulte o estado da tarefa com o
task_idfornecido. - Descarregue os resultados de
result_urlquando o estado for “exported”. - Trate os diferentes códigos de estado na sua aplicação.
Perguntas frequentes
1. Qual a capacidade de processamento da API?
A API pode processar grandes lotes com atualizações de estado em tempo real.
2. Em que formato deve estar o ficheiro de entrada?
Ficheiro de texto com um número por linha em formato E.164 (ex. +41798284651).
3. Que informação devolve a API?
Devolve estado da conta WhatsApp, assinatura do utilizador (ex. “Hey there! I am using WhatsApp”) e marca temporal da última atualização de estado.
4. Qual o preço?
O preço é 2 USD por 10.000 números para informação detalhada (atualizações de estado e assinaturas).
Para mais informações sobre preços e volumes maiores, contacte-nos.