DB34T 3498-2019 党政机关公务用车管理信息平台接口规范.docxVIP

ICS35.240L70

DB34

安徽省地方标准DB34/T3498—2019

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

Interfacespecificationofmanagementinformationplatformforofficialvehiclesofpartyandgovernmentorgans

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

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

I

DB34/T3498—2019

前言

本标准按照GB/T1.1-2009给出的规则起草。本标准由安徽省机关事务管理局提出并归口。

本标准起草单位：安徽省机关事务管理局、安徽中科美络信息技术有限公司、安徽省质量和标准化研究院、中国科学院合肥物质科学研究院、合肥市机关事务管理局、芜湖市机关事务管理局、马鞍山市机关事务管理中心、滁州市机关事务管理局、宣城市机关事务管理局。

本标准主要起草人：陶钧、邹月明、黄晓芳、周献志、佟杰、邢鹏、尚春、潘勤华、李广胜、李骏、刘罡、郑云卿、吴仲城、罗健飞、张文秋、武理芬、王碧菁、王学永、戴朋龙、付应翠。

1

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加入到传递的参数中；

2

DB34/T3498—2019

b)将传递的参数(包括accessKey和reqTime)按照参数名称key从小到大排序,以形式连接成字符串进行URL编码，将请求的URI进行URL编码后和参数字符串连接形成新字符串，并使用国密SM3算法进行加密生成sign；

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

4.3输入与输出

4.3.1公共输入参数

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

参数

类型

说明

accessKey

String

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

reqTime

String

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

sign

String

签名

4.3.2公共输出参数

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

表2公共输出参数

参数

类型

说明

message

String

返回信息说明

result

String

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

code

String

返回信息提示码

model

String

返回具体数据信息

4.4接口返回提示码

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

表3接口返回提示码

code

说明

200

成功

601,602,603

相关操作执行成功

20000

失败

20001

用户不存在

20002

缺失签名字段

20003

服务单位Id为空

20004

申请人信息不完整

20013

无服务单位

20014

签名验证失败

20015

请求时间过期

20016

请求时间不存在

3

DB34/T3498—2019

表3（续）

code

说明

280018

accessKey不存在

280023

地区ID不存在

280026

单位名称不存在

280030

参数不存在

280033

没有权限进行该操作