金润数科高速通·人车关系核验接口文档

本文涉及的产品
密钥管理服务KMS,1000个密钥,100个凭据,1个月
简介: 人车关系核验接口介绍:核验指定人员/企业是否是指定车辆的ETC开户人、车辆所有人或ETC经办人(企业)更新时间:实时接口类型:API接口数据优势:直连交通部路网中心,合法合规、权威、精确数据安全:只认证是否通过,保护个人信息隐私计费方式:核验计费

金润征信-高速通-人车关系核验接口文档



版本号

修订内容

时间

备注说明

V1.0

新建

2022.6. 7

 

 

 

 

 

 

 

 

 

目录

1.接口描述

2.加密方式

2.1加签,验签机制说明

2.2签名算法

2.3加密方式

2.4生成签名

2.4.1筛选并排序

2.4.2拼接

2.4.3调用签名函数

2.4.4拼接完整请求

3.请求参数

3.1公共请求参数

3.2接口请求参数

4.响应参数

4.1公共响应参数

4.2接口响应参数

5.代码示例

5.1请求示例

5.2响应示例

5.3异常示例

6.附录

6.1接口返回码

1. 人车关系核验接口描述

接口名称

高速通-人车关系核验

接口编号

JR-GST-001

接口描述

核验指定人员/企业是否是指定车辆的ETC开户人、车辆所有人或ETC经办人(企业)

接口地址

/dmp/api

请求方式

POST

加密方式

RSA2

 

注意事项:

当返回码“为20001”时, 需要调用“上传授权委托书接口”先上传授权委托书,上传成功之后,重新调用本接口。

2. 人车关系核验接口加密方式

2.1 加签,验签机制说明

客户在应用中使用自己的“私钥”对消息加签之后,消息和签名会传递给金枢系统,金枢系统则使用应用的 公钥 验证消息的真实性(来自于合法应用的真实消息)。

对于金枢系统返回消息给商户应用的情形,应用则使用金枢系统的 公钥 来验证返回消息的真实性。

 

2.2 签名算法

签名算法:RSA2

标准签名算法:SHA256WithRSA

描述:强制要求 RSA 密钥的长度至少为 2048。

 

2.3 加密方式

请求体加密

将请求参数(biz_content)字段通过 私钥进行加密

 

2.4 生成签名

2.4.1 筛选并排序

获取所有请求参数(包括公共请求参数),不包括字节类型参数,如文件、字节流,剔除 sign 字段,剔除值为空的参数,并按照第一个字符的键值 ASCII 码递增排序(字母升序排序),如果遇到相同字符则按照第二个字符的键值 ASCII 码递增排序,以此类推。

2.4.2 拼接

将排序后的参数与其对应值,组合成 参数=参数值 的格式,并且把这些参数用 & 字符连接起来,此时生成的字符串为待签名字符串。

示例:

app_id=2014072300XXXXXX&biz_content=fV9IJsNcmZcPEQbvr8S3kkJ3uT0GRfHlAM25LT8w9xCAJqywxotrVlH1ZJsIXwHBvz97uFyNbBoSKbxfRgwKLl7P88hKBmPDwyDzB4t8MT&charset=UTF-8&method=alipay.trade.pay&sig

 

2.4.3 调用签名函数

使用各自语言对应的 SHA256WithRSA(对应 sign_type 为 RSA2)签名函数利用商户私钥对签名字符串进行签名,并进行 Base64 编码。把生成的签名 encode 后赋值给 sign 参数,拼接到请求参数中。

 

2.4.4 拼接完整请求

调用签名函数 后需将生成的签名作为 sign 的 value 拼接到请求数据中。

示例:

app_id=2014072300XXXXXX&biz_content=fV9IJsNcmZcPEQbvr8S3kkJ3uT0GRfHlAM25LT8w9xCAJqywxotrVlH1ZJsIXwHBvz97uFyNbBoSKbxfRgwKLl7P88hKBmPDwyDzB4t8MT&charset=UTF-8&method=alipay.trade.pay&sign_type=RSA2×tamp=2014-07-24 03:07:50&version=1.0&sign=GhT5Q6YxBtvf4q855TiNWEF/DIeLMyEE97+OnJDHpe6joNfr9F3BAE37dczcogU7uLfpNo+dh3cgly05bQN5nTj9TJ3SrBZWa40cltlgkI+6+0FuJoFSA225+MCrD4fNNqi2Zd5Adi9qC9NdN8nBVsjvzqtn5NepOt8dG1qdv7KvVwG74emFea1j2JuMBVBMp2PgIEwCv5c8OJSXa2P66+l3YCqEEMjBN22Dz0chlJ4hKMW3rA2oISH6ryzIvNIiy4/djKEdmxFeBorp1vrbmAtBqE++afggzzGt5w4arkbQ4fWLXJwkC9+1y4irCgmX65CEb5ct+fRgG2/9/B0rYg==

 

2.5 解密方式

返回数据data内容是加密的,要用商户的公钥解密

 

3. 人车关系核验接口请求参数

3.1 公共请求参数

参数

类型

必填

最大长度

说明

app_id

String

Y

32

金润商务提供

method

String

Y

100

固定值:

"jinrun.car.person.verify"

sign

String

Y

 

参见2加密方式

charset

String

Y

10

utf-8

format

String

Y

10

json

sign_type

String

Y

10

RSA2

version

String

Y

10

1.0

 

3.2 接口请求参数

参数

类型

必填

最大长度

说明

biz_content

plateColor

Integer

Y

2

车牌颜色

0-蓝色,1-黄色,

2-黑色,3-白色,

4- 渐变绿色

5- 黄绿双拼色

6- 蓝白渐变色

7- 临时牌照

11-绿色

12-红色

plateNum

String

Y

10

车牌号

name

String

Y

18

个人姓名/企业名称

tel

String

N

18

手机号/经办人手机号

idNum

String

Y

30

身份证号/企业证件号

agentName

String

N

50

经办人姓名

agentIdNum

String

N

50

经办人身份证号

serialNo

String

N

50

流水号

userCode

String

Y

100

用户唯一code

 

提示:姓名/手机号/身份证号不可都为空

4. 人车关系核验接口响应参数

4.1 公共响应参数

参数

类型

说明

code

String

响应码参见附录6

request_id

String

请求Id

message

String

响应信息

timestamp

Long

时间戳

data

String

返回数据

 

4.2 接口响应参数

参数

类型

说明

checkResult

String

返回人是车的:

1-ETC开户人

2-车辆所有人

3-ETC经办人

4-未查得

返回结果如果是多个,以竖线相连,如:1|2|3

serialNo

String

流水号

5. 人车关系核验接口代码示例

5.1 请求示例

biz_content的json格式样例

{

    "plateNum":"闽A5L9xx",

    "plateColor":1,

    "name":"翁xx",

    "idNum":"35012819790624xxxx",

"serialNo":"55ac9936-a625-4059-af19-9f162329b10a",

    "userCode":"xxxx",

 

}

5.2 响应示例

{

    "request_id": "SN1531641993443282944",

    "code": "00000",

    "data": {

        "checkResult": "1|2",

        "serialNo": "55ac9936-a625-4059-af19-9f162329b10a"

    },

    "message": "操作成功",

    "timestamp": 1654006882812

}

 

5.3 异常示例

6. 人车关系核验接口附录

6.1 接口返回码

编码

描述

是否收费

00000

查询成功

收费

20001

需要先调用上传授权书接口

免费

400

服务器不理解请求的语法。

免费

401

请求要求身份验证。

免费

403

服务器拒绝请求。

免费

404

服务器找不到请求的网页。

免费

405

禁用请求中指定的方法。

免费

406

无法使用请求的内容特性响应请求的网页。

免费

407

请求要求身份验证。

免费

408

服务器等候请求时发生超时。

免费

409

服务器在完成请求时发生冲突。

免费

410

如果请求的资源已永久删除,服务器就会返回此响应。

免费

411

服务器不接受不含有效内容长度标头字段的请求。

免费

412

服务器未满足请求者在请求中设置的其中一个前提条件。

免费

413

服务器无法处理请求,因为请求实体过大,超出服务器的处理能力。

免费

414

请求的 URI(通常为网址)过长,服务器无法处理。

免费

415

请求的格式不受请求页面的支持。

免费

416

如果页面无法提供请求的范围,则服务器会返回此状态代码。

免费

417

服务器未满足期望请求标头字段的要求。

免费

500

服务器遇到错误,无法完成请求。

免费

501

服务器不具备完成请求的功能。

免费

502

服务器作为网关或代理,从上游服务器收到无效响应。

免费

503

服务器目前无法使用(由于超载或停机维护)。

免费

504

服务器作为网关或代理,但是没有及时从上游服务器收到请求。

免费

505

服务器不支持请求中所用的 HTTP 协议版本。

免费

703

参数非法或者为空。

免费

704

业务查询失败。

免费

711

无数据。

免费

716

响应失败。

免费

949

协议中未定义此类文件名(协议调用错误,文件名不正确)。

免费

950

鉴权失败。

免费

951

文件md5校验失败。

免费

999

未知错误。

免费

 

相关文章
金润·高速通-高速通行费查验接口文档
高速通行费查验接口介绍:查询企业/个人(ETC开户人/车辆所有人)名下所有车辆,月/周通行费用总值 更新时间:实时 接口类型:API接口 数据优势:直连交通部路网中心,合法合规、权威、精确 数据安全:仅提供月/周通行费用总值,保护个人信息隐私 计费方式:核验计费,详情请咨询
金润·高速通-高速通行费查验接口文档
|
JSON 算法 安全
金润·核验通-运营商在网状态接口文档
运营商在网状态接口介绍:提供用户手机号,核验用户手机在网状态正常、停机、销号、在网但不可用等状态 更新时间:实时 接口类型:API接口 数据优势:直连官方数据,合法合规、权威、精确 数据安全:仅确认在网状态,保护个人信息安全 计费方式:核验计费,详情请咨询
金润·核验通-运营商在网状态接口文档
金润·核验通-运营商二要素验证接口文档
接口介绍:输入身份证号码及手机号,通过运营商数据库实时校验此二项是否匹配 更新时间:实时 接口类型:API接口 数据优势:直连官方数据,合法合规、权威、精确 数据安全:基于授权,通过正规渠道获取运营商信息 计费方式:核验计费,详情请咨询
金润·核验通-运营商二要素验证接口文档
|
JSON 算法 安全
金润·核验通-运营商在网时长接口文档
运营商在网时长接口介绍:提供用户手机号,核验用户在运营商激活手机号正常使用至今的时长 更新时间:实时 接口类型:API接口 数据优势:直连官方数据,合法合规、权威、精确 数据安全:仅提供用户在网时长,保护个人信息安全 计费方式:核验计费,详情请咨询
金润·核验通-运营商在网时长接口文档
金润·核验通-企业四要素核验接口文档
企业四要素核验接口介绍:企业名称、企业标识、姓名、身份证号四要素核验 更新时间:实时 接口类型:API接口 数据优势:直连官方数据信息,合法合规、权威、精确 数据安全:仅确认是否一致,保护个人信息隐私 计费方式:核验计费,详情请咨询
金润·核验通-企业四要素核验接口文档
|
JSON 算法 安全
金润·核验通-运营商三要素验证接口文档
接口介绍:支持三大运营商所有号码核验,通过比对姓名、身份证号、手机号的一致性 更新时间:实时 接口类型:API接口 数据优势:直连官方数据,合法合规、权威、精确 数据安全:官方数据,只核验三要素之间的一致性,保护个人信息安全 计费方式:核验计费,详情请咨询
金润·核验通-运营商三要素验证接口文档
|
JSON 文字识别 算法
金润·核验通-身份证识别接口文档
【身份证识别接口】支持对二代居民身份证所有字段的结构化OCR识别提取,支持正、反面身份证识别。支持全国各区域身份证识别。【身份证识别-身份证OCR-身份证正反面图像信息提取-身份证OCR识别-身份证识别-身份证图片识别-身份证识别】《身份证核验、身份证实名认证、身份证实名认证、人脸实名认证》。上海金润联汇数字科技有限公司是一家以ETC为切入点,深耕交通行业,服务于交通生态的数据科技服务平台。2014年开始为货车提供高速通行ETC后付费业务,超10年行业运营经验。货车ETC后付费业务年交易额超150亿元,规模全国屈指可数。与鲁苏浙赣粤黔赣湘闽沪藏。
金润·核验通-身份证识别接口文档
金润·核验通-工商三要素接口文档
工商三要素接口介绍:企业名,统一社会信用代码,法定代表人姓名一致性验证 更新时间:实时 接口类型:API接口 数据优势:直连官方数据信息,合法合规、权威、精确 数据安全:仅确认是否一致,保护个人信息隐私 计费方式:核验计费,详情请咨询
金润·核验通-工商三要素接口文档
金润·高速通-车辆信息查验接口文档
车辆信息查验接口介绍:查询指定人员/企业(ETC开户人/车辆所有人)指定时间内所有车辆的车牌号、车型、轴数及ETC卡信息 更新时间:实时 接口类型:API接口 数据优势:直连交通部路网中心,合法合规、权威、精确 数据安全:只查验车辆信息,保护个人信息隐私 计费方式:核验计费,详情请咨询
金润·高速通-车辆信息查验接口文档
|
JSON 文字识别 算法
金润·核验通-个人身份验证接口文档
与身份证OCR技术完美融合,实时快速核实身份信息真实性【实名认证】【身份认证】【身份实名认证】【身份证】【身份证二要素】【身份证二要素核验】【身份证二要素实名认证】【身份证认证】【身份证识别】【身份证实名核验】【身份证实名认证】【身份证实名认证查询】【身份证实名认证接口】【身份证实名认证校验】【身份证实名认证验证】【身份证实名校验】【身份证验证】【身份证一致性实名认证】【实名】【实名鉴权验证】【实名认证】【实名认证api】【实名认证核查】【实名认证接口】【实名验证】【身份证核验】【实名认证身份证】【身份证实名验证】【身份证实名认证api】【实名认证api接口】【身份证实名认证api接口】
金润·核验通-个人身份验证接口文档