跳转到内容

流程总览

批量检测为异步流程:提交号码 → 获得 token → 轮询进度 → 下载结果文件。

端点方法用途
/v1/balanceGET查询当前账号的可用 USD 余额
/v1/detectPOST提交电话号码或邮箱地址的 JSON 数组
/v1/detect/filePOST提交 TXT/CSV 文件
/v1/tasks/{token}GET轮询任务状态
/v1/tasks/{token}/resultGET获取结果文件下载地址
/v1/tasks/{token}/downloadGET下载结果文件本体

两个提交接口都返回 HTTP 202 Accepted——任务的生命周期长于这一次请求。

  • 数量:至少达到所选产品的最小提交量(依产品为 500、1,000 或 2,000 条,见批量产品列表),最多 2,000,000 行。
  • 号码格式:需包含国际区号,如 +8613800138000。
  • 国家:电话类产品传入 ISO 3166-1 二位国家码(例如 CN、US);邮件类产品请完全省略该字段。可选代码见国家代码列表。