陕西公车监督管理平台接口及接入规范v1.docVIP

陕西省公车监督管理平台接口陕西省公车监督管理平台接口

及接入规范V1.1及接入规范V1.1

接口及接入规范

文档控制

日期作者版本变更说明

2019-07-201.0初版

2019-07-221.1增加对跨区域调度的流程描述，公里油

耗、运行费用、车辆新购、报废、拍卖

统计接口的接口说明

第2页共22页

接口及接入规范

目录

1文档说明41.1编制说明41.2适用范围42接入系统接口定义42.1用户认证说明42.2获取单位信息42.3获取车辆信息52.4获取订单信息72.5获取任务单信息82.6获取车辆最新定位92.7获取车辆最新订单信息102.8获取车辆历史轨迹112.9获取公里油耗112.10获取运行费用122.11获取单位车辆新购、报废、拍卖统计信息132.12获取无任务出行\节假日出行142.13获取超速预警\终端预警152.14新增跨区域调度订单接口162.15获取车辆购置信息182.16获取车辆报废处置信息192.17获取驾驶员信息202.18获取保险信息预警信息21

第3页共22页

接口及接入规范

1文档说明

1.1编制说明

本规范主要为各对接省公车监督平台的应用系统提供接口规范。

1.2适用范围

本规范适用于接入陕西省公车监督管理平台的各应用系统，应用系统可以根据本接口规范进行产品的接入开发。

2接入系统接口定义

接入系统按以下接口定义提供接口，由陕西监督平台调用接入系统接口获取相关信息;

2.1用户认证说明

请求头中增加token信息，接入系统使用监督平台提供的用户密码、算法、秘钥，对token进行校验;

2.2获取单位信息

请求接口:/baseinfo/dept

请求方式:post

请求参数:

字段类型长度描述

lastVersionTimeString32上次版本时间;格式yyyy-MM-ddHH:mm:ss

targetVersionTimeString32本次版本时间;格式yyyy-MM-ddHH:mm:ss

queryTypeInteger获取方式;1增量、2全量pageSizeInteger每次获取条数

currentPageInteger当前页

响应结果:

{

code:10000,

msg:,

data:{

total:0,//总数

rows:[{单位信息},{单位信息},{单位信息}]

}

}

第4页共22页

接口及接入规范

单位信息响应字段说明:

字段类型长度描述

deptCodeString64单位编码deptNameString64单位名称cityCodeString8城市编码countyCodeString8区县编码

单位级别;0科级，1处级，2局级，3厅级，4deptLevelInteger省部级

deptPropertyInteger单位性质;1党政机关，2企事单位，3其他

peoplePrepareNumInteger在编人数vehiclePrepareNumInteger车辆编制数cjNumInteger处级干部数dependentString64隶属关系contactNameString32单位联系人contactPhoneString32单位联系电话deptDutyString255部门职责deptAddrString128办公地址deptSortInteger单位排序deptBudgetDouble经费预算(万元)flagInteger操作标识;1新增、2更新、3删除

2.3获取车辆信息

请求接口:/baseinfo/vehicle

请求方式:post

请求参数:

字段类型长度描述

上次版本时间;格式yyyy-MM-ddlastVersionTimeString32HH:mm:ss

本次版本时间;格式yyyy-MM-ddtargetVersionTimeString32HH:mm:ssqueryTypeInteger获取方式;1增量、2全量

pageSizeInteger每次获取条数currentPageInteger当前页响应结果:

{

code:10000,

msg:,

data:{

total:0,//总数

rows:[{车辆信息},{车