跳转到内容
Zelnum API

提交号码检测

POST/v1/detect

提交号码或邮箱数组发起检测任务，异步处理。费用按提交总数预扣，完成后自动退回无法检测的部分。

返回 HTTP 202 Accepted。

请求参数

Section titled “请求参数”
字段类型必填说明
productstring是产品 slug，见批量产品列表。
countrystring电话类产品必填ISO 3166-1 二位国家码，例如 CN、US——完整列表见国家代码列表。邮件类产品请省略该字段。
phonesarray是同一系列的电话号码或邮箱地址数组。

响应示例

Section titled “响应示例”
{
  "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
  }
}

响应字段

Section titled “响应字段”
字段类型说明
modestring批量提交固定为 async。
task_idstring轮询与下载时使用的令牌，即任务接口路径中的 {token}。
idempotent_replayboolean为 true 时表示本次提交复用了已有任务，并未新建。
recovery_pendingboolean为 true 时表示任务已入队，但账务仍在核对中。
messagestring人类可读的下一步提示。
summary.totalinteger已接收的行数。
summary.cost_deductednumber本次提交预扣的金额。

请保存 task_id——它是你握有这项任务的唯一凭据，事后无法凭号码反查。

下一步

Section titled “下一步”