金润·高速通-单车高速通行费变化接口文档

简介: 单车高速通行费变化接口介绍:查询企业/个人(ETC开户人/车辆所有人)名下所有车辆中,每辆车(指定时间段)的通行费同比变化、环比变化更新时间:实时接口类型:API接口数据优势:直连交通部路网中心,合法合规、权威、精确数据安全:只认证是否通过,保护个人信息隐私计费方式:核验计费,详情请咨询

金润·高速通-单车高速通行费变化接口文档


 目录

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-007

接口描述

查询车辆的通行费波动信息(以月为单位)

接口地址

/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.highway.pass.fee.change"

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

name

String

Y

18

个人姓名/企业名称

tel

String

N

18

手机号/经办人手机号

idNum

String

Y

30

身份证号/企业证件号

plateColor

Integer

Y

2

车牌颜色

0-蓝色,1-黄色,

2-黑色,3-白色,

4- 渐变绿色

5- 黄绿双拼色

6- 蓝白渐变色

7- 临时牌照

11-绿色12-红色

plateNum

String

Y

10

车牌号

agentName

String

N

50

经办人姓名

agentIdNum

String

N

50

经办人身份证号

startTime

String

Y

10

yyyy-MM-dd,必须是1号开始

如:2021-10-01

endTime

String

Y

10

yyyy-MM-dd,必须是月末结束

如:2021-10-31

serialNo

String

Y

50

流水号

userCode

String

Y

50

授权UserCode,参考授权接口文档

monthNumber

String

Y

2

月份数量

 

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

4. 单车高速通行费变化接口响应参数

4.1 公共响应参数

参数

类型

说明

code

String

响应码参见附录6

request_id

String

请求Id

message

String

响应信息

timestamp

Long

时间戳

data

String

返回数据

 

4.2 接口响应参数

参数

类型

说明

serialNo

String

流水号

percentageOfTollRanking

Double

通行费排名占比

tollRankingYearOnYear

Double

通行费排名同比

tollRankingMonthOnMonth

Double

通行费排名环比

5. 单车高速通行费变化接口代码示例

5.1 请求示例

biz_content的json格式样例

{

    "plateNum":"湘DB36xx",

    "plateColor":1,

    "name":"唐xx",

    "tel":"",

    "idNum":"43290119790409xxxx",

    "userCode":"xxx",

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

    "startTime":"2021-09-01",

    "endTime":"2021-09-30"

}

5.2 响应示例

{

    "request_id": "SN1534417688791748608",

    "code": "00000",

    "data": {

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

        "tollRankingMonthOnMonth": 10,

        "percentageOfTollRanking": 9,

        "tollRankingYearOnYear": 11

    },

    "message": "操作成功",

    "timestamp": 1654668659889

}

 

 

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

未知错误。

免费

 

相关文章
|
存储 人工智能 OLAP
LangChain+通义千问+AnalyticDB向量引擎保姆级教程
本文以构建AIGC落地应用ChatBot和构建AI Agent为例,从代码级别详细分享AI框架LangChain、阿里云通义大模型和AnalyticDB向量引擎的开发经验和最佳实践,给大家快速落地AIGC应用提供参考。
131599 94
|
Dubbo Java 应用服务中间件
微服务框架(十四)Spring Boot @ControllerAdvice异常处理
此系列文章将会描述Java框架Spring Boot、服务治理框架Dubbo、应用容器引擎Docker,及使用Spring Boot集成Dubbo、Mybatis等开源框架,其中穿插着Spring Boot中日志切面等技术的实现,然后通过gitlab-CI以持续集成为Docker镜像。   本文为Spring Boot使用@ControllerAdvice进行自定义异常捕捉
|
缓存 网络协议 网络架构
【计算机网络】第三章 数据链路层(MAC地址 IP地址 ARP协议)
【计算机网络】第三章 数据链路层(MAC地址 IP地址 ARP协议)
lombok~避免Boolean属性使用默认的方法
【9月更文挑战第25天】在 Lombok 中,默认会为 `Boolean` 属性生成 `isXXX` 方法。若要避免此默认行为,可通过三种方式实现:1)使用 `@Getter/@Setter` 注解的 `name` 属性自定义方法名;2)通过 `@Data` 注解的 `access` 属性设置为 `FIELD` 直接访问字段;3)使用 `@Builder` 注解在生成的 builder 类中指定方法名。这些方法允许你根据需求定制属性访问方式。
454 1
|
9月前
|
SQL 监控 druid
Java Druid 面试题
Java Druid 连接池相关基础面试题
|
6月前
|
SQL 人工智能 自然语言处理
Text2SQL圣经:从0到1精通Text2Sql(Chat2Sql)的原理,以及Text2Sql开源项目的使用
Text2SQL圣经:从0到1精通Text2Sql(Chat2Sql)的原理,以及Text2Sql开源项目的使用
Text2SQL圣经:从0到1精通Text2Sql(Chat2Sql)的原理,以及Text2Sql开源项目的使用
|
SQL 自然语言处理 测试技术
NL2SQL进阶系列(4):ConvAI、DIN-SQL等16个业界开源应用实践详解[Text2SQL]
NL2SQL进阶系列(4):ConvAI、DIN-SQL等16个业界开源应用实践详解[Text2SQL]
NL2SQL进阶系列(4):ConvAI、DIN-SQL等16个业界开源应用实践详解[Text2SQL]
|
SQL 自然语言处理 关系型数据库
NL2SQL进阶系列(3):Data-Copilot、Chat2DB、Vanna Text2SQL优化框架开源应用实践详解[Text2SQL]
NL2SQL进阶系列(3):Data-Copilot、Chat2DB、Vanna Text2SQL优化框架开源应用实践详解[Text2SQL]
NL2SQL进阶系列(3):Data-Copilot、Chat2DB、Vanna Text2SQL优化框架开源应用实践详解[Text2SQL]
|
SQL 自然语言处理 算法
NL2SQL基础系列(1):业界顶尖排行榜、权威测评数据集及LLM大模型(Spider vs BIRD)全面对比优劣分析[Text2SQL、Text2DSL]
NL2SQL基础系列(1):业界顶尖排行榜、权威测评数据集及LLM大模型(Spider vs BIRD)全面对比优劣分析[Text2SQL、Text2DSL]
NL2SQL基础系列(1):业界顶尖排行榜、权威测评数据集及LLM大模型(Spider vs BIRD)全面对比优劣分析[Text2SQL、Text2DSL]
金润·高速通-高速通行费查验接口文档
高速通行费查验接口介绍:查询企业/个人(ETC开户人/车辆所有人)名下所有车辆,月/周通行费用总值 更新时间:实时 接口类型:API接口 数据优势:直连交通部路网中心,合法合规、权威、精确 数据安全:仅提供月/周通行费用总值,保护个人信息隐私 计费方式:核验计费,详情请咨询
金润·高速通-高速通行费查验接口文档