空号检测API对接教程（附接口参数说明）

一句话定义：空号检测 API，是把号码检测能力接进你自己系统的方式——你的系统通过 HTTP 接口提交号码，平台把状态结果返回给你。

它适合已经自建 CRM、外呼平台、营销后台的团队：把号码流转自动化，不用再手动上传文件、手动下载结果。

什么时候才需要 API

如果你有自己的系统（CRM、外呼平台、营销后台），而且不想每次手动传文件、手动收结果，就该上 API 了。

反过来，量不大、人手也少，用平台的文件上传功能完全够——API 是为"系统与系统之间对话"准备的。

接口就三件事

一个完整的接入，核心只有三个接口：

1. 提交检测任务 —— 把号码列表通过 HTTP 传过去；
2. 查询检测结果 —— 平台是异步检测的，完成后通过查询接口（或回调）把结果给你；
3. 下载结果文件 —— 拿到状态码，逐条对回你自己的名单。

"异步"是关键词：提交完不用干等，检测完成再取结果就行。

提交接口要看哪些参数

返回的结果里，是每个号码对应的状态码。

对接前先确认两件事

• 状态码定义：返回的 1、2、3… 各代表什么，每个平台可能不一样，以对方文档为准；
• 先联调再上量：正式接入前，用小批量号码跑一遍，核对结果字段和状态码是否跟你预期一致。

对接难吗？

有现成文档就不难——开发照着接口文档调就行，平台一般也提供技术支持。

真正的坑不在"调通"，而在"状态码对不上你的业务逻辑"——所以联调那一步，别省。