· 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âmetroTipoDescrição
filefileFicheiro com números a verificar, um número por linha
task_typestringws_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

CampoDescrição
NumberNúmero em formato E.164
signatureAssinatura do estado WhatsApp
status_updateHora da última atualização de estado
whatsappSe o número tem conta WhatsApp ativa

Códigos de estado

EstadoDescrição
200Pedido com sucesso, tarefa criada ou estado obtido (pago)
400Pedido inválido, parâmetros ou formato inválidos (grátis)
500Erro interno do servidor, tente mais tarde (grátis)

Notas de integração

  1. Cada linha do ficheiro deve conter um número em formato E.164.
  2. Consulte o estado da tarefa com o task_id fornecido.
  3. Descarregue os resultados de result_url quando o estado for “exported”.
  4. 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.

Related Posts

View All Posts »