简介
Zelnum API 提供简单统一的 JSON 接口,支持号码批量检测(异步)与实时单号检测。
接口基础地址
Section titled “接口基础地址”所有端点均以 /api/v1 为前缀:
https://app.zelnum.com/api/v1本文档所有示例均使用该基础地址。
所有接口统一返回 JSON。
典型工作流程
Section titled “典型工作流程”- 查询余额 —
GET /v1/balance - 提交检测任务 —
POST /v1/detect(号码数组)或POST /v1/detect/file(文件上传) - 轮询任务状态 —
GET /v1/tasks/{task_id}直到completed或failed - 下载结果文件 —
GET /v1/tasks/{task_id}/result
单号码同步检测请参阅实时单号检测。
- 批量(异步):提交时按总数预扣费用;被预过滤、去重或未能检测的号码在任务结算时自动退款。
- 实时:每个产品按单次检测价计费;仅
valid与invalid收费,unknown、超时与通道不可用自动退款。