空号检测接口文档（V1）
接口地址
POST http://ip:port/sms/Api/MobileNullCheck.do
说明：
ip:port由平台在开户后提供。
请求方式
- Method: POST
- Content-Type:
application/x-www-form-urlencoded; charset=UTF-8
功能描述
用于检测指定手机号是否为空号、停机、关机或其他异常状态。调用成功后，系统返回该号码的实时状态信息。
认证说明
- 密码生成规则：
将企业用户名与原始密码拼接后，进行 32 位大写 MD5 加密，作为Password参数值。
示例：- 用户名：
user - 原始密码：
password - 拼接字符串：
userpassword - MD5（大写）：
D440AED189A13FF970DAC7E7E8F987B2
- 用户名：
⚠️ 请勿直接使用明文密码！
请求参数
| 参数名称 | 描述 | 是否必填 | 示例值 |
|---|---|---|---|
| SpCode | 企业 ID | ✅ | 10001 |
| LoginName | 企业用户名 | ✅ | user |
| Password | 加密后密码 | ✅ | D440AED189A13FF970DAC7E7E8F987B2 |
| Phone | 待检测手机号 | ✅ | 13245678902 |
返回参数
| 字段 | 描述 | 示例值 |
|---|---|---|
| code | 状态码 | 0（成功）、1（平台失败）、2（远程检测失败） |
| msg | 结果描述 | 根据 code 返回对应提示信息 |
| data | 检测结果详情（仅当 code=0 时存在） | 见下表 |
Data 字段详情
| 字段 | 描述 | 示例值 |
|---|---|---|
| Phone | 请求的手机号 | 13245678902 |
| desc | 状态中文描述 | 空号、关机、正常 等 |
| Result | 状态码（与运营商回执一致） | MK:0001、MI:0024、DELIVRD 等 |
常见状态码说明
| Result | 含义 | desc 示例 |
|---|---|---|
DELIVRD | 正常 | 正常 |
MI:0024 | 关机 | 关机 |
DB:0102 | 停机 | 停机 |
MK:0001 | 空号 | 空号 |
DB:0114 | 未知状态 | 未知 |
DB:9903 | 检测超时 | 检测超时 |
💡 返回的
desc字段为便于理解的中文描述，Result为原始状态码，建议以Result为准进行程序判断。