DB34/T 3498-2019 党政机关公务用车管理信息平台接口规范

ICS35.240

L70

DB34

安徽省地方标准

DB34/T3498—2019

党政机关公务用车管理信息平台接口规范

Interfacespecificationofmanagementinformationplatformforofficialvehiclesof

partyandgovernmentorgans

文稿版次选择

2019-12-25发布2020-01-25实施

安徽省市场监督管理局发布

DB34/T3498—2019

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由安徽省机关事务管理局提出并归口。

本标准起草单位：安徽省机关事务管理局、安徽中科美络信息技术有限公司、安徽省质量和标准化

研究院、中国科学院合肥物质科学研究院、合肥市机关事务管理局、芜湖市机关事务管理局、马鞍山市

机关事务管理中心、滁州市机关事务管理局、宣城市机关事务管理局。

本标准主要起草人：陶钧、邹月明、黄晓芳、周献志、佟杰、邢鹏、尚春、潘勤华、李广胜、李骏、

刘罡、郑云卿、吴仲城、罗健飞、张文秋、武理芬、王碧菁、王学永、戴朋龙、付应翠。

I

DB34/T3498—2019

党政机关公务用车管理信息平台接口规范

1范围

本标准规定了党政机关公务用车管理信息平台接口的术语和定义、接口基本要求和用户平台接口。

本标准适用于党政机关公务用车管理信息平台接口的设计与开发。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T5271.1信息技术词汇第1部分：基本术语

3术语和定义

GB/T5271.1界定的以及下列术语和定义适用于本文件。

3.1

开放平台openplatform

提供一系列计算机易识别的数据接口，以供第三方开发者使用的平台。

4接口基本要求

4.1接口形式

对开放平台的服务接口的访问采用唯一资源标识符（URL网址），应通过HTTP协议提交POST请

求的方式进行。

4.2接口安全认证

4.2.1签名认证

调用方应在开放平台进行登记备案，登记备案时，开放平台为用户分配用户标识accessKey。调用

方调用开放平台的服务接口时对参数进行加密生成签名，签名以参数的形式传递，服务接口接收签名后

进行签名验证。

4.2.2签名步骤

签名步骤包括：

a)生成签名时,将分配的accessKey和当前时间reqTime加入到传递的参数中；

1

DB34/T3498—2019

b)将传递的参数(包括accessKey和reqTime)按照参数名称key从小到大排序,以&形式连接成字

符串进行URL编码，将请求的URI进行URL编码后和参数字符串连接形成新字符串，并使用国

密SM3算法进行加密生成sign；

c)将生成的sign和其他参数一起传递。

4.3输入与输出

4.3.1公共输入参数

调用方在访问开放平台的服务接口时公共输入参数见表1。

表1公共输入参数

参数类型说明

accessKeyString标识开发者身份，由开放平台提供

reqTimeString请求接口时的北京时间，格式为yyyy-MM-ddHH:mm:ss

signString签名

4.3.2公共输出参数

开放平台服务接口的公共输出参数信息见表2。

表2公共输出参数

参数类型说明

messageString返回信息说明

resultString返回成功与否标识：success成功，fail失败

codeString返回信息提示码

modelString返回具体数据信息

4.4接口返回提示码

接口返回提示码信息见表3。

表3接口返回提示码

code说明

200成功

601,602,603相关操作执行成功

20000失败

20001用户不存在

20002缺失签名字段

20003服务单位Id为空

20004申请人信息不完整

20013无服务单位

20014签名验证失败

20015请求时间过期

20016请求时间不存在

2

DB34/T3498—2019

表3（续）

code说明

280018accessKey不存在

280023地区ID不存在

280026单位名称不存在

280030参数不存在

280033没有权限进行该操作

100000添加成功

100001修改成功

100002删除成功

200000添加失败

200001修改失败

200002删除失败

200032由于部门中存在用户,无法删除

200031存在下级部门，请勿删除

200030部门不存在

200006部门已存在，请勿重复添加

200019手机号已经存在

200045参数错误

200011车辆类型已存在，请勿重复添加

200012车牌号已存在，请勿重复添加

200014驾驶员已存在，请勿重复添加

200016车型已绑定车辆，请勿删除

4.5登记备案

4.5.1接口名称

登记备案接口。

4.5.2接口描述

开放平台创建授权账户。

4.5.3接口范式

POST:http://…/user/create

4.5.4请求参数

登记备案的请求参数见表4。

表4登记备案请求参数

参数类型最大长度说明

userNameString20用户名称,字母数字下划线

phoneString11用户号码

3

DB34/T3498—2019

表4（续）

参数类型最大长度说明

emailString50用户邮箱

organNameString50单位名称

applicationIdString20用户所属应用ID，没有可不传

customerTypeString20用户类型，没有可不传

addressString200用户地址

uniqueCodeString20用户编码，没有可不传

4.5.5返回参数

登记备案返回参数见表5。

表5登记备案返回参数

参数类型说明

messageString返回信息说明

resultString返回成功与否标识：success成功，fail失败

codeString返回信息提示码

accessKeyString用户标识

securityKeyString用户秘钥

organIdString用户单位Id

5用户平台接口

第三方通过HTTP协议提交POST请求调用开放平台的服务接口向用户平台传递数据。接口请求调

用关系见图1。

开放平台（服务接口）

用户单位

车辆

请求

部门

驾驶员

第三方

用户

订单

车型

图1接口请求调用关系

5.1用户单位

5.1.1新增用户单位

接口名称

4

DB34/T3498—2019

新增用户单位接口。

接口描述

在用户平台中新增用户单位，获取用户单位标识。

接口范式

POST:http://…/refactor/refactoringOrgan/addOrgan

请求参数

新增用户单位请求参数见表6。

表6新增用户单位请求参数

参数类型最大长度说明

organNameString50用户单位名称

执法单位类型：一般机关单位NONE，综合执法

lawTypeString根据枚举值确定

COMPOSITELAW，执法执勤DUTYLAE

roleTypeString根据枚举值确定用户单位类型：用户平台LOGISTICS，执法平台LAW

用户单位子类型：

机关单位GOVERMENT，事业单位NATIONALAGENCY，

organTypeString根据枚举值确定

国有企业NATIONALCOMPANY，一般企业单位

GENERALCOMPANY

areaIdString20地区Id

verticalSysString20垂直体系编码

organLevelInt3单位级别

customerServicePhoneString255客服电话

licenceIssuingAuthorityString255发证机关

characterOfInstitutionString255单位性质

organCodeString20单位内部代码

示例：（参数）

{

"areaId":"0100124108104",

"characterOfInstitution":"NATIONALAGENCY",

"customerServicePhone":"0551-XXXXXXX",

"lawType":"NONE",

"licenceIssuingAuthority":"",

"organCode":"CX291XXX",

"organLevel":"3",

"organName":"安徽省某某事务管理局",

"organType":"GOVERMENT",

"roleType":"LOGISTICS",

"verticalSys":"AGRICULTURE"

}

5

DB34/T3498—2019

返回参数

新增用户单位返回参数见表7。返回参数示例参见附录A。

表7新增用户单位返回参数

参数类型说明

messageString返回信息说明

resultString返回成功与否标识：success成功，fail失败

codeString返回信息提示码

modelString用户单位Id(即organId)

5.1.2修改用户单位

接口名称

修改用户单位接口。

接口描述

修改用户平台中用户单位信息。

接口范式

POST:http://…/refactor/refactoringOrgan/editOrgan

请求参数

修改用户单位请求参数见表8。

表8修改用户单位请求参数

参数类型最大长度说明

organIdString40用户单位Id

organNameString50用户单位名称

执法单位类型：一般机关单位NONE，综合执法

lawTypeString根据枚举值确定

COMPOSITELAW，执法执勤DUTYLAE

roleTypeString根据枚举值确定用户单位类型：用户平台LOGISTICS，执法平台LAW

用户单位子类型：机关单位GOVERMENT，事业单位

organTypeString根据枚举值确定NATIONALAGENCY，国有企业NATIONALCOMPANY，一般企

业单位GENERALCOMPANY

areaIdString20地区Id

sortNoInt3排序值：不小于0的整数

verticalSysString20垂直体系编码

organLevelInt3单位级别

customerServicePhoneString255客服电话

licenceIssuingAuthorityString255发证机关

characterOfInstitutionString255单位性质

organCodeString20单位内部代码

6

DB34/T3498—2019

示例：（参数）

{

"areaId":"0100124108101",

"characterOfInstitution":"机关单位",

"customerServicePhone":"0551-XXXXXXX",

"lawType":"NONE",

"organCode":"CX230XXX",

"organId":"79e0fe07b42542c7b928942011fxxxxx",

"organLevel":"3",

"organName":"安徽省某某技术局",

"organType":"GOVERMENT",

"roleType":"LOGISTICS",

"sortNo":"2418",

"verticalSys":"AGRICULTURE"

}

返回参数

修改用户单位返回参数见表9。返回参数示例参见附录A。

表9修改用户单位返回参数

参数类型说明

messageString返回信息说明

resultString返回成功与否标识：success成功，fail失败

codeString返回信息提示码

modelString返回空值

5.1.3删除用户单位

接口名称

删除用户单位接口。

接口描述

删除用户平台中的用户单位信息。

接口范式

POST:http://…/refactor/refactoringOrgan/deleteOrgan

请求参数

删除用户单位请求参数见表10。

表10删除用户单位请求参数

参数类型最大长度说明

organIdString40用户单位Id

7

DB34/T3498—2019

示例：（参数）

{

"organId":"d620e4dbd3cf496580a89b89076xxxxx"

}

返回参数

删除用户单位返回参数见表11。返回参数示例见附录A(资料性附录)。

表11删除用户单位返回参数

参数类型说明

messageString