接口名称

高速通-车辆高速里程变化

接口编号

JR-GST-004

接口描述

查询指定人员/企业（ETC开户人）的所有车辆的高速总通行里程

接口地址

/dmp/api

请求方式

POST

加密方式

RSA2

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

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

参数

类型

必填

最大长度

说明

app_id

String

Y

32

金润商务提供

method

String

Y

100

固定值：

"jinrun.highway.car.mileage.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

参数

类型

必填

最大长度

说明

biz_content

name

String

Y

18

个人姓名/企业名称

tel

String

N

18

手机号/经办人手机号

idNum

String

Y

30

身份证号/企业证件号

agentName

String

N

50

经办人姓名

（如果开户人姓名为空则必填）

agentIdNum

String

N

50

经办人身份证号

（如果开户人证件号为空则必填）

startDate

String

Y

10

yyyy-MM-dd

当单位为月时，开始时间必须为单位月份的第一天

endDate

String

Y

10

yyyy-MM-dd

当单位为月时，结束时间必须为单位月份的最后一天

serialNo

String

Y

50

流水号

userCode

String

Y

50

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

参数

类型

说明

code

String

响应码参见附录6

request_id

String

请求Id

message

String

响应信息

timestamp

Long

时间戳

data

String

返回数据

参数

类型

说明

hasData

Boolean

true/false

model

Object

模型对象

serialNo

String

流水号

vehiclePassMileageRateModelList

List

车辆通行里程变动查询信息

vehicleId

String

车牌号码

ringRatio

Double

通行总里程数环比

yearOveryear

Double

里程数同比值

{

    "name":"翁xx",

    "idNum":"35012819790624xxxx",

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

    "userCode":"23xxx",

    "startDate":"2021-01-01",

"endDate":"2021-02-28"

}

{

    "request_id": "SN1534374908535115776",

    "code": "00000",

    "data": {

        "hasData": false,

        "model": {

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

            "vehiclePassMileageRateModelList": [

                {

                    "ringRatio": 0,

                    "vehicleId": "京2345",

                    "yearOveryear": 0

                }

            ]

        }

    },

    "message": "操作成功",

    "timestamp": 1654658460284

}

编码

描述

是否收费

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

未知错误。

免费