下载结果

GET/v1/tasks/{token}/result

当 result_available 为 true 后，该接口返回结果文件的下载链接与最终统计数字。结果文件默认保留 7 天，由平台的 result_retention_days 设置控制。

响应示例

{
  "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
  }
}

响应字段

字段	类型	说明
`task_id`	string	任务令牌，原样回传。
`download_url`	string（URL）	结果文件所在位置。调用时需要与其他接口相同的 API Key。
`expires_at`	string（ISO 8601）\| null	文件停止可下载的时间。
`summary.submitted`	integer	本次提交收到的行数。
`summary.prefiltered`	integer	检测前被丢弃的行数。
`summary.deduped`	integer	被去重移除的行数。
`summary.total`	integer	实际被检测的行数。
`summary.valid`	integer	确认已注册的行数。
`summary.invalid`	integer	确认未注册的行数。
`summary.unknown`	integer	上游无法给出结论的行数。
`summary.unknown_processed`	integer	已重试并得出结果的 unknown 行。
`summary.unknown_unprocessed`	integer	仍未解决的 unknown 行，这部分会退款。

下载文件

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

该接口返回的是文件流而非 JSON：application/zip，当任务只产生一个结果文件时为 text/csv。任务不存在、已过期或属于其他账号时返回 404；任务尚未完成时返回 422 result_not_ready。

download_url 与该接口可以互换使用——提供链接是为了让浏览器或工作进程无需自己拼接路径就能取到文件。

下一步

批量示例——把提交 → 轮询 → 下载整个流程写在一个脚本里