简介
Zelnum API 通过统一的 JSON 接口，提供手机号与邮箱的批量检测（异步）和实时单条检测。
接口基础地址
Section titled “接口基础地址”所有端点均以 /api/v1 为前缀：
https://api.zelnum.com/api/v1这是机器调用的 API 域名。控制台位于 app.zelnum.com，用于创建 Key、充值与查看记录 —— 它与 API 域名刻意分开，以便 API 侧独立扩容与接入防护。本文档所有示例均使用上述基础地址。
| 步骤 | 页面 |
|---|---|
| 1. 拿到 Key 并发出第一个请求 | 认证 |
| 2. 确认账户有余额 | 查询余额 |
| 3. 了解响应约定 | 响应格式 |
选择检测模式
Section titled “选择检测模式”| 模式 | 适用场景 | 从这里开始 |
|---|---|---|
| 实时检测 | 只有一个标识，或几条，现在就要结果 | 实时检测 |
| 批量检测 | 有成千上万条，可以等 | 批量检测 |
一个标识 × 1 到 10 个产品 × 一次调用，立即返回结论，按产品计费。
提交数组或文件，轮询任务，下载结果。按实际检测的行数计价——价格见你账户中的价格页面。
- 批量（异步）：提交时按总数预扣费用；被预过滤、去重或未能检测的号码在任务结算时自动退款。
- 实时：每个产品按单次检测价计费；仅
valid与invalid收费，unknown、超时与通道不可用自动退款。详见计费与退款。
官方 SDK
Section titled “官方 SDK”Python 客户端把本页的接口封装成类型化调用：返回值带类型、幂等键与批量结果下载都由它处理。目前官方只维护这一个 SDK，其他语言直接调用 REST API。