所有文档

短信服务

语音服务

个人信息核验

运营商信息核验

银行信息核验

企业信息核验

车辆出行

应用开发

文字识别

数字权益

企业服务

基础知识

开发参考

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

空号检测

产品详情

余额查询接口

1、接口描述

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

2、请求地址

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

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、请求参数说明

参数名称	参数值描述	示例	类型	必填

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	状态码（2成功）	OK\|ParamError	string
msg	结果描述	请求成功\|参数错误	string
data	数据		object
balance	剩余检测条数	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":
                {    "balance":
                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、代码示例

免费体验

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