API de Verificação de Números OKX

Verifique em lote o registro de números na OKX e baixe os resultados exportados.

Parâmetros do produto

Parâmetro	Valor
Tipo de tarefa	okx
Tipo de entrada	Telefone no formato E.164
Mínimo de entradas válidas	2,000

estimated_amount é calculado com o preço da conta e é a referência de cobrança da tarefa.

Formato de entrada

Envie um arquivo .txt ou .csv com um telefone por linha. Recomenda-se E.164.

+14155552671
+442071838750

Criar uma tarefa

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="okx"'

A API retorna um ID de tarefa. Guarde-o para consultar o status.

Resposta do envio

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 2000,
  "estimated_amount": {
    "amount": "3.000000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Consultar o status

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Consulte até status ser exported. pending e processing ainda não estão concluídos.

Resposta em processamento

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 2000,
  "success": 1000,
  "failure": 0
}

Resposta exportada

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 2000,
  "success": 2000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "3.000000",
    "currency": "USD"
  }
}

Campos de resultado

Campo	Descrição	Exemplo
number / Number	Telefone de entrada. CSV usa number; XLSX usa Number.	+14155552671
activated	Indica se uma conta foi detectada para o número.	yes / no

Linhas sem conta retornam activated=no; campos de perfil ficam vazios quando não há dados.

Tratamento do arquivo

Baixe o pacote por result_url somente após a exportação e preserve os nomes das colunas.

Campos da resposta

Campo	Descrição
created_at	Data de criação.
updated_at	Última atualização.
task_id	ID exclusivo da tarefa.
status	pending, processing, exported ou failed.
total	Total de entradas válidas.
success	Valores processados com sucesso.
failure	Valores com falha.
result_url	URL de download após exportar.
actual_amount	Valor final, quando disponível.
estimated_amount	Valor estimado na criação.

Códigos de status

Status	Descrição
200	Solicitação bem-sucedida.
202	Tarefa criada e cobrança estimada aplicada.
400	Arquivo inválido, tipo não suportado ou entradas insuficientes.
401	API Key ausente ou inválida.
402	Saldo insuficiente.
404	Tarefa não encontrada.
413	Arquivo muito grande.
500	Erro interno; tente novamente mais tarde.

Notas operacionais

• A tarefa é assíncrona; consulte com o ID retornado.
• Somente números válidos e normalizados contam para o mínimo.
• Tarefas com falha são reembolsadas automaticamente conforme o faturamento.