所有文档

短信服务

语音服务

个人信息核验

运营商信息核验

银行信息核验

企业信息核验

车辆出行

应用开发

文字识别

数字权益

企业服务

基础知识

开发参考

文档中心 > 运营商信息核验 > 空号检测

空号检测

产品详情

空号检测提交接口

1、接口描述

通过 POST 方式提交，数据编码采用 utf-8 格式。
签名认证【必读】签名机制文档：https://www.ihuyi.com/api/request.html

实时返回检测结果及计费状态

2、请求地址

https://api.ihuyi.com/empty-number/submit

3、请求头说明

参数名称	参数值描述	示例	类型	必填
Content-Type	内容类型，固定值	application/json	string	是
Date	GMT时间，误差±300秒	Mon, 16 Jun 2025 08:24:34 GMT	string	是
Authorization	签名头	Signature keyId="end7348191", algorithm="hmac-sha256", ...	string	是

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
mobiles	手机号数组（最多10个）	["135xxxxxxxx","136xxxxxxxx"]	array	是

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	状态码（见下方说明）	OK\|ParamError	string
msg	结果描述	请求成功\|参数错误	string
data	数据		array
mobile	手机号	136xxxxxxxx	string
state	状态码(1：正常;2：空号;3：沉默号;4：风险号;-1：未知)	1	int
charge_state	计费状态(1：扣费;-1：不扣费)	1	int

6、响应状态码说明

code	msg
0	未知错误
2	请求成功
400	非法IP访问
403	应用不存在
405	API ID或API KEY不正确
4050	余额查询失败
40505	没有签订合同
4051	剩余条数不足
1100	参数错误

7、GET传参示例

不支持

8、响应示例

示例（成功）

{    "code":
            "OK"
        ,        "msg":
            "请求成功"
        ,        "data":
            [    {    "mobile":
                "136xxxxxxxx"
                    ,        "state":
                1
                    ,        "charge_state":
                1
                        }
    ]            }

示例（失败）

{"code":"ParamError","msg":"参数错误"}

9、PHP生成动态密码方式代码示例

$keyId = 'xxxxxxxxxxxxxxxx'; //可登录用户中心查看，对应APIID
$Data = gmdate('D, d M Y H:i:s \G\M\T');
$algorithm = 'hmac-sha256';
$signature = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'; // 请替换为您的签名字符串，可参考：https://gitee.com/shsurlink/api-demo/blob/master/hmac-auth/php/IhuyiSignatureHelper.php
$Authorization = sprintf('Signature keyId="%s", algorithm="%s", headers="%s", signature="%s"', $keyId, $algorithm, '@request-target date host', $signature)

//注意：所有字符编码统一为UTF-8

空号检测

空号检测提交接口

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

9、PHP生成动态密码方式代码示例

10、代码示例

免费体验

填写验证码后，点击“开通体验账户”自动开通体验账户。