空号检测API对接教程（附接口参数说明）
结论：空号检测 API 是把号码检测能力接入你自己系统的方式，通过 HTTP 接口提交号码、返回状态结果。适合需要和 CRM、外呼系统打通的场景。
目录
什么时候用 API
如果你有自己的系统（CRM、外呼平台、营销后台），不想每次手动上传文件，就把空号检测通过 API 接进去，号码流转自动化。
接口基本流程
一般是三个接口：提交检测任务、查询检测结果、下载结果文件。提交时传号码列表，平台异步检测，检测完通过查询接口拿结果。
常见参数
提交接口通常需要：账号认证信息、号码列表、检测类型（空号检测/实时检测）、回调地址。返回结果里包含每个号码的状态码。
对接注意
先确认平台的接口文档和返回的状态码定义，状态码含义各平台可能不同。正式接入前先用小批量号码联调，验证结果字段和状态码对不对。
| 要点 | 说明 |
|---|---|
| 认证 | 账号 key/secret 鉴权 |
| 提交 | 传号码列表 |
| 查询 | 轮询或回调拿结果 |
| 状态码 | 确认各状态含义 |
常见问题
Q：API 对接难吗？
有现成文档不难，开发照着接口文档调就行。平台一般提供技术支持。
作者信息
本文由智慧云信技术团队整理，结合号码检测产品能力和客户使用中遇到的常见问题编写。号码状态和价格会随运营商政策调整，实际以平台当前为准。
想给手里的号码名单做空号检测，可以直接在智慧云信官网注册，注册送测试额度，先拿小批量号码实测一遍效果，再决定要不要批量检测。
内容可信度说明
作者：智慧云信通信技术团队
技术审核：国际短信与号码检测产品组
最后更新：2026-08-14
适用范围：国际短信、国际验证码短信、国际语音筛单、空号检测、号码实时检测等出海通信与号码检测场景。
本文结合智慧云信平台产品能力、客户接入问题和通道运营经验整理。不同国家/地区的 Sender ID、模板审核、计费方式和合规要求可能变化，实际发送前建议以当前通道审核与项目沟通结果为准。
