Enviar Verificação (Array)

POST/v1/detect

Envie um array de números de telefone para verificação. Processado assincronamente. O custo é pré-deduzido; números não verificados são reembolsados automaticamente.

HTTP 202 Accepted

Parâmetros

Campo	Tipo	Obrigatório	Descrição
product	string	Sim	Slug do produto — Lista de Produtos
country	string	Obrigatório para telefone	Produtos de telefone: o código ISO 3166-1 alfa-2, por exemplo CN ou US. Produtos de e-mail: omita este campo por completo. — Códigos de país
phones	array	Sim	Array de números de telefone ou endereços de e-mail de uma única série.

Nota

O envio deve atingir o mínimo do produto selecionado — 500, 1,000 ou 2,000, dependendo do produto, exibido na lista de produtos em lote — e ficar abaixo do máximo da plataforma, de 2,000,000. Um envio abaixo do mínimo é rejeitado como too_few_numbers.

O campo country só existe nos produtos de telefone

E-mail não tem dimensão de país. Enviar country com um produto de e-mail falha na validação. É o espelho dos endpoints em tempo real, onde country é opcional mas deve ser omitido para e-mail.

Exemplo de Resposta

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "idempotent_replay": false,
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

Campos da resposta

Campo	Tipo	Descrição
mode	string	Sempre async em envios em lote.
task_id	string	Token usado para consultar e baixar. É o parâmetro de caminho {token} dos endpoints de tarefa.
idempotent_replay	boolean	true quando o envio reutilizou uma tarefa anterior em vez de criar uma nova.
recovery_pending	boolean	true quando a tarefa está na fila, mas sua contabilização ainda está sendo reconciliada.
message	string	Próximo passo em linguagem legível.
summary.total	integer	Linhas aceitas.
summary.cost_deducted	number	Valor pré-deduzido pelo envio.

A seguir

• Enviar um arquivo em vez de um array
• Consulte o status da tarefa até o trabalho terminar