户籍信息查询接入规范.docx
- 文档编号:20250243
- 上传时间:2023-04-25
- 格式:DOCX
- 页数:10
- 大小:18.24KB
户籍信息查询接入规范.docx
《户籍信息查询接入规范.docx》由会员分享,可在线阅读,更多相关《户籍信息查询接入规范.docx(10页珍藏版)》请在冰豆网上搜索。
户籍信息查询接入规范
户籍信息查询接入规范
鉴权数据中心
文档信息
文档版本号
V1.0
起草人
起草日期
2016/10/08
审核人
审核日期
2016/10/10
批准人
审核日期
2016/10/12
修订记录
版本
日期
作者
说明
V1.0
2016/10/08
初稿
V1.0
2016/10/12
定稿
本文档中的所有内容为鉴权数据中心的机密和专属所有。
未经鉴权数据中心的明确书面许可,任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。
目录
1概述4
2接口介绍4
2.1通讯协议4
2.2安全协议4
2.2.1加解密4
2.2.2签名方式4
2.3接入规则5
2.3.1IP绑定5
2.3.2使用范围5
2.3.3字符编码5
2.4户籍信息查询5
2.4.1请求接口地址(POST、GET)5
2.4.2请求接口5
2.4.3接口返回7
2.4.4错误代码定义9
1概述
户籍信息查询规范文档主要用于制定标准的接口接入准则及流程,指导用户开发人员及测试等相关技术人员快速了解鉴权数据中心提供的数据接口方式和相关规范,并且方便快捷的实现接口对接。
2接口介绍
2.1通讯协议
鉴权数据中心对外数据接口主要以http协议发布
2.2安全协议
2.2.1加解密
鉴权数据中心接口根据主流加解密方法定义了标准统一的加解密方式,DESede进行加解密,即:
鉴权数据中心针对用户申请的接口分配唯一的接入秘钥,用户通过所分配的秘钥及任意随机的8位偏移量进行数据加密。
Stringdata=allJson.toString();
System.out.println("请求报文:
"+data);
//平台分配的唯一的接入秘钥
StringprivateKey="l4mdofLTvHkyONpdlyXBiaTv";
Stringvector="12345678";//随机8位偏移量
StringencrData=Cipher3DES.encrypt(data,privateKey,vector);
System.out.println("加密报文:
"+encrData);
2.2.2签名方式
接入方对自己加密完成的请求报文字符串进行签名(注意:
是加密后再签名),鉴权数据中心提供统一的RSA签名方式,即:
用户可在平台在线生成或者自行生成签名密钥对,同时将签名公钥上传至平台,私钥留下自己注意保密,通过生成的签名私钥进行签名,产生签名值。
通过平台签名公钥和平台返回签名值进行验签。
//根据用户自己的签名私钥对加密报文进行签名
Stringsignature=RsaSignCoder.sign(encrData,signPrivateKey);
System.out.println("签名值:
"+signature);
//根据平台签名公钥对平台返回的加密报文进行验证签名
booleanisTrue=RsaSignCoder.verify(datas,signPublicKey,sign);
注:
具体请参考示例代码
2.3接入规则
2.3.1IP绑定
用户在进行接入的时候需要向鉴权数据中心提供接入服务器的一个或多个公网IP。
2.3.2使用范围
鉴权数据中心对于敏感数据接口,每次请求需要说明查询原因作为中心留存,用户必须与鉴权数据中心签署数据使用相关责任协议。
鉴权数据中心会为每一个接入用户分配唯一的用户编号,用户可使用同一个用户编号申请多个数据接口,但每个接口分别生成不同的密钥进行加解密及签名。
注:
鉴权数据中心针对一个用户多接口只提供多个加密秘钥,一个签名公钥,本地签名密钥对用户自己生成。
2.3.3字符编码
鉴权数据中心接口接收和返回统一以UTF-8字符集编码格式进行接收返回
2.4户籍信息查询
2.4.1请求接口地址(POST、GET)
2.4.2请求接口
接受参数:
参数名称
参数说明
condition
请求条件的加密报文
userCode
平台分配的用户编号
signature
加密请求报文的签名值
vector
加密偏移量,用户随机生成8位随机数字或字母
条件字段说明:
字段名称
注释说明
请求说明
qryBatchNo
查询批次号
唯一,不超过20位
userCode
商户编号
平台分配的商户编号
sysCode
应用编号
平台创建应用分配的唯一编号
qryReason
查询原因
简单说明调用原由,可为空
qryDate
查询日期
格式:
yyyyMMdd,可为空
qryTime
查询时间
格式:
hhmmss,可为空
realName
姓名
不超过20位
idCard
身份证号码
正确的身份证号码
请求条件报文格式:
{
"header":
{
"qryBatchNo":
"20160525151642123",
"userCode":
"TEST10001",
"sysCode":
"TESTAPP10001",
"qryReason":
"信贷",
"qryDate":
"20160526",
"qryTime":
"113106"
},
"condition":
{
"realName":
"张三",
"idCard":
"430721************"
}
2.4.3接口返回
返回参数:
参数名称
参数说明
contents
返回数据的加密报文
signature
加密请求报文的签名值
正确返回字段说明:
字段名称
字段说明
header
报文头
name
返回数据的名称
recordNum
返回数据的数量
realName
真实姓名
idCard
身份证号码
nativePlace
籍贯
birthDay
出身日期
sex
性别:
01:
男性、02:
女性、03:
未说明性别、04:
未知的性别
education
文化程度
maritalStatus
婚姻状况:
01:
离婚、02:
丧偶、03:
复婚、04:
再婚、05:
初婚、06:
已婚、07:
未婚、08:
未说明婚姻状况
photo
照片:
预留字段
birthPlace
出生地
nation
民族
formerName
曾用名
address
住址
company
工作单位
resCode
结果代码
resDesc
结果描述
resCode结果为:
00:
成功查得且一致、98:
未查得或查得但是不一致
正确返回报文格式:
{
"header":
{
"qryBatchNo":
"20160525151642123",
"userCode":
"HFUSER10001",
"sysCode":
"APP10001",
"qryReason":
"信贷",
"qryDate":
"20160526",
"qryTime":
"030322"
{
{
"data":
[
{
"name":
"户籍信息查询",
"recordNum":
1,
"record":
[
{
"realName":
"丁健锋",
"idCard":
"310228198003193618",
"nativePlace":
"上海市金山县",
"birthDay":
"1980-03-19",
"sex":
"01",
"education":
"初中",
"maritalStatus":
"06",
"photo":
"",
"birthPlace":
"上海市金山县",
"nation":
"汉族",
"formerName":
"",
"address":
"漕泾镇",
"company":
"金山区漕泾镇邓桥村",
"resCode":
"00",
"resDesc":
"成功查得且一致"
}
]
}
]
}
},
错误返回字段说明:
字段名称
字段说明
code
错误代码
codeDesc
错误代码描述
错误返回报文格式:
{
"msg":
{
"codeDesc":
"姓名校验不通过",
"code":
"01"
}
}
2.4.4错误代码定义
错误代码
代码描述说明
00
成功查得且一致
98
未查得或查得但是不一致
01
姓名校验不通过
02
身份证号码有误
10
请求条件有缺失,请确认是否遗漏
20
您的体验次数已使用完,请完成正式签约
30
您的签约次数已使用完,请续约购买次数
40
您的应用未绑定该数据通道,请确认应用编号是否正确或完成绑定
44
数据渠道已关闭
55
请求验签失败,请确认加密秘钥和偏移量是否正确
66
未开通该数据渠道
77
数据渠道已被禁用,暂无限权
88
未上传签名或加解密公钥,请上传相关公钥
99
交易失败
备注:
不收费代码:
10、20、30、40、44、55、66、77、88、99其余都收费
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 户籍 信息 查询 接入 规范
![提示](https://static.bdocx.com/images/bang_tan.gif)