API de verificação de número em massa do Telegram: verificação rápida de número de telefone

Verifique os detalhes do Telegram do número global de entrada, se é uma conta do Telegram

Exemplo de código do arquivo de detecção de upload:

curl --location 'https://api.checknumber.ai/tg/api/simple/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'user_id="USER_ID"' \
--form 'file=@"input.txt"'

Exemplo de código de verificação de status da tarefa:

curl --location 'https://api.checknumber.ai/tg/api/simple/tasks/cs9viu7i61pkfs4oavvg?user_id=USER_ID' \
--header 'X-API-Key: API-KEY'

Resposta para o upload do arquivo de detecção bem-sucedido

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Resposta para o status de processamento

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Forneça uma resposta indicando que a tarefa foi concluída e inclua o URL de download dos resultados.

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

URL de solicitação de upload de arquivo

POST https://api.checknumber.ai/tg/api/simple/tasks

Parâmetros de solicitação de upload de arquivo

Parâmetro	Descrição
user_id	string, ID do usuário
file	file, Arquivo de upload, cada linha deve conter um número de telefone no formato E.164

URL de solicitação de verificação de status da tarefa

GET https://api.checknumber.ai/tg/api/simple/tasks/{TASK_ID}

Parâmetros de solicitação de verificação de status da tarefa

Parâmetro	Descrição
user_id	string, ID do usuário

Campos de resultado

Campo	Descrição	Exemplo
Number	Número de telefone no formato E.164	+41798284651
telegram	Se o número tem uma conta Telegram ativa	sim, não

Formato de resposta

Campo	Descrição
created_at	Timestamp de quando a tarefa foi criada
updated_at	Timestamp da última atualização do status da tarefa
task_id	Identificador exclusivo da tarefa
user_id	ID do usuário
status	Status da tarefa: pending: Em fila e aguardando processing: Processando atualmente completed: Processamento concluído exported: Resultados disponíveis para download
total	Total de números de telefone processados
success	Números identificados com sucesso
failure	Números que falharam no processamento
result_url	(Opcional) URL de download para resultados quando o status é exported

Códigos de status

Status	Descrição
200	charge, Solicitação bem-sucedida, tarefa criada ou status recuperado
400	free, Solicitação incorreta, parâmetros ou formato de arquivo inválidos
500	free, Erro interno do servidor, tente novamente mais tarde