空号检测 - 常见问题

什么是空号检测接口？
空号检测接口是用于验证手机号是否真实存在的工具。支持判断号码是否为空号、沉默号、停机号、风险号等，适用于营销前数据清洗、提升拨号效率等场景。

空号检测支持哪些运营商？
目前支持中国大陆三大运营商：移动、联通、电信的11位手机号。

每次最多能提交多少个手机号？
每次接口调用最多支持提交10个手机号，超过限制将返回参数错误。

空号检测接口调用后多久能返回检测结果？
空号检测为实时接口，提交后立即返回检测结果和计费状态，适合在用户注册、批量营销前快速筛查号码有效性。

空号检测检测结果中的 state 字段是什么意思？
state=1 表示有效号码；2 表示空号；3 表示沉默号（长期未活跃）；4 表示高风险号码（如停机）；-1 表示检测失败或状态未知。

什么是 charge_state 字段？
charge_state 表示当前号码是否计费：1 为计费，-1 为不计费。通常只有当号码状态为“正常”时才会计费，异常状态将不计费。

空号检测接口如何进行加密与认证？
所有请求需使用 HMAC-SHA256 签名认证，并在请求头中传递 Authorization 签名字段。签名方式请参阅：签名机制说明。

查询账户剩余检测条数的接口怎么使用？
调用余额查询接口 `https://api.ihuyi.com/empty-number/balance`，提交带有签名的 GET 请求即可获取账户剩余可用检测次数。

调用空号检测接口失败时如何排查问题？

请查看返回的 code 和 msg 字段信息，例如 4051 表示剩余条数不足，400 表示非法 IP，1100 表示参数格式错误。建议结合接口文档检查请求结构与签名。

空号检测是否提供开发示例和接入指南？
互亿无线提供完整的空号检测 API 接口文档、签名机制说明、以及多语言 DEMO 示例（Java、PHP、Python、Go 等），方便快速接入。查看签名机制文档