所有文档

短信服务

语音服务

个人信息核验

运营商信息核验

银行信息核验

企业信息核验

车辆出行

应用开发

文字识别

数字权益

企业服务

基础知识

开发参考

文档中心 > 个人信息核验 > 身份证四要素

身份证四要素

产品详情

查询账户余额

1、接口描述

请求支持 POST 和 GET 两种方法，字符编码为 utf-8。

2、请求地址

https://api.ihuyi.com/idcard/id4/GetNum.json

3、请求头说明

参数名称	参数值描述	示例	类型	必填
Content-Type	内容类型，固定值	application/x-www-form-urlencoded	string	是

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【认证核验】-【身份信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【身份信息验证】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
time	Unix时间戳（10位整型数字，使用动态密码方式时必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|0	int	是
msg	提交结果描述	查询成功\|查询失败	string	是
num	余额值	123456｜0	int	否

6、响应状态码说明

code	msg
0	未知错误
1	查询失败
2	查询成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	应用不存在
404	姓名不能为空
4041	姓名格式不正确（2-10个中文汉字）
406	身份证号码不能为空
4061	身份证格式不正确
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
4052	访问 ip 与备案 ip 不符

7、GET传参示例

https://api.ihuyi.com/idcard/id4/GetNum.json?account=xxxxxxxx&password=xxxxxxxxx&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><GetNumResult><code>2</code><msg>查询成功</msg><num>123456｜0</num></GetNumResult>

{    "code":
            2
        ,        "msg":
            "查询成功"
        ,        "num":
            123456｜0
            }

示例（失败）

<?xml version="1.0" encoding="utf-8"?><GetNumResult><code>0</code><msg>查询失败</msg></GetNumResult>

{"code":0,"msg":"查询失败"}

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

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'id4'; //固定值
$time = '1623643787';
$password=md5($account.$password.$app.$time);
$password=md5('xxxxxxxxxxxxxxxxxid41623643787');

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

身份证四要素

查询账户余额

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

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

10、代码示例

免费体验

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