URL de Download

GET/v1/tasks/{token}/result

Após concluída, recupere uma URL de download para o arquivo de resultado. Os arquivos são mantidos por 7 dias por padrão (controlado pela configuração result_retention_days).

Exemplo de Resposta

{
  "task_id": "xKj9aP3qLm7v",
  "download_url": "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download",
  "expires_at": "2026-05-02T10:00:00+00:00",
  "summary": {
    "submitted": 5000,
    "prefiltered": 0,
    "deduped": 0,
    "total": 5000,
    "valid": 3800,
    "invalid": 1200,
    "unknown": 0,
    "unknown_processed": 0,
    "unknown_unprocessed": 0
  }
}

Campos da resposta

Campo	Tipo	Descrição
task_id	string	Token usado para consultar e baixar. É o parâmetro de caminho {token} dos endpoints de tarefa.
download_url	string (URL)	URL do arquivo de resultado. Exige a mesma chave de API que todas as outras chamadas.
expires_at	string (ISO 8601) | null	Quando o arquivo deixa de poder ser baixado.
summary.submitted	integer	Linhas recebidas no envio.
summary.prefiltered	integer	Linhas descartadas antes da detecção — linhas malformadas, por exemplo.
summary.deduped	integer	Linhas duplicadas removidas.
summary.total	integer	Linhas realmente enfileiradas para detecção, após a pré-filtragem e a deduplicação.
summary.valid	integer	Linhas confirmadas como registradas.
summary.invalid	integer	Linhas confirmadas como não registradas.
summary.unknown	integer	Linhas que o provedor não conseguiu resolver.
summary.unknown_processed	integer	Linhas desconhecidas que foram reprocessadas e concluídas.
summary.unknown_unprocessed	integer	Linhas desconhecidas ainda não resolvidas. Estas são reembolsadas.

Cuidado

Baixe o arquivo antes de expires_at. Arquivos de resultado expirados são excluídos permanentemente e não podem ser recuperados.

Baixar o arquivo de resultados

GET/v1/tasks/{token}/download

curl -X GET "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -o result.zip

Transmite o arquivo de resultados já concluído diretamente como anexo. Você pode seguir o download_url retornado pelo endpoint de resultado ou chamar este endpoint com o mesmo token de tarefa.

Depois que o período de retenção termina, o arquivo é excluído e este endpoint retorna 404 — é preciso enviar a tarefa novamente para gerá-lo outra vez.

• 404 — O task_id não existe ou pertence a outra conta.
• 404 — O arquivo de resultado está expirado, ausente ou indisponível.
• 422 — A tarefa não foi concluída ou seu arquivo de resultado ainda não foi gerado.

A seguir

• Exemplos em lote — todo o ciclo enviar → consultar → baixar em um único script