DB34 T 3498-2019 党政机关公务用车管理信息平台接口规范.pdf
《DB34 T 3498-2019 党政机关公务用车管理信息平台接口规范.pdf》由会员分享,可在线阅读,更多相关《DB34 T 3498-2019 党政机关公务用车管理信息平台接口规范.pdf(32页珍藏版)》请在麦多课文档分享上搜索。
1、ICS 35.240 L 70 DB34 安徽省地方标准 DB 34/T 34982019 党政机关公务用车管理信息平台接口规范 Interface specification of management information platform for official vehicles of party and government organs 文稿版次选择 2019 - 12 - 25 发布 2020 - 01 - 25 实施 安徽省市场监督管理局 发布 DB34/T 34982019 I 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。 本标准由安徽省机关事务管理局提
2、出并归口。 本标准起草单位:安徽省机关事务管理局、安徽中科美络信息技术有限公司、安徽省质量和标准化 研究院、中国科学院合肥物质科学研究院、合肥市机关事务管理局、芜湖市机关事务管理局、马鞍山市 机关事务管理中心、滁州市机关事务管理局、宣城市机关事务管理局。 本标准主要起草人:陶钧、邹月明、黄晓芳、周献志、佟杰、邢鹏、尚春、潘勤华、李广胜、李骏、 刘罡、郑云卿、吴仲城、罗健飞、张文秋 、武理芬、王碧菁、王学永、戴朋龙、付应翠。 DB34/T 34982019 1 党政机关公务用车管理信息平台接口规范 1 范围 本标准规定了党政机关公务用车管理信息平台接口的术语和定义、接口基本要求和用户平台接口。
3、本标准适用于党政机关公务用车管理信息平台接口的设计与开发。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T 5271.1 信息技术 词汇 第1部分:基本术语 3 术语和定义 GB/T 5271.1 界定的以及下列术语和定义适用于本文件。 3.1 开放平台 open pl atform 提供一系列计算机易识别的数据接口,以供第三方开发者使用的平台。 4 接口基本要求 4.1 接口形式 对开放平台的服务接口的访问采用唯一资源标识符(URL 网址),应通过
4、HTTP 协议提交 POST 请 求的方式进行。 4.2 接口安全认证 4.2.1 签名认证 调用方应在开放平台进行登记备案,登记备案时,开放平台为用户分配用户标识 accessKey。调用 方调用开放平台的服务接口时对参数进行加密生成签名,签名以参数的形式传递,服务接口接收签名后 进行签名验证。 4.2.2 签名步骤 签名步骤包括: a) 生成签名时,将分配的 accessKey 和当前时间 reqTime 加入到传递的参数中; DB34/T 34982019 2 b) 将传递的参数(包括 accessKey 和 reqTime)按照参数名称 key 从小到大排序,以&形式连接成字 符串进行
5、 URL 编码,将请求的 URI 进行 URL 编码后和参数字符串连接形成新字符串,并使用国 密 SM3 算法进行加密生成 sign; c) 将生成的 sign 和其他参数一起传递。 4.3 输入与输出 4.3.1 公共输入参数 调用方在访问开放平台的服务接口时公共输入参数见表1。 表1 公共输入参数 参数 类型 说明 accessKey String 标识开发者身份,由开放平台提供 reqTime String 请求接口时的北京时间,格式为yyyy-MM-dd HH:mm:ss sign String 签名 4.3.2 公共输出参数 开放平台服务接口的公共输出参数信息见表2。 表2 公共输出
6、参数 参数 类型 说明 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 请求时
7、间不存在 DB34/T 34982019 3 表 3 (续) code 说明 280018 accessKey不存在 280023 地区ID不存在 280026 单位名称不存在 280030 参数不存在 280033 没有权限进行该操作 100000 添加成功 100001 修改成功 100002 删除成功 200000 添加失败 200001 修改失败 200002 删除失败 200032 由于部门中存在用户,无法删除 200031 存在下级部门,请勿删除 200030 部门不存在 200006 部门已存在,请勿重复添加 200019 手机号已经存在 200045 参数错误 200011 车
8、辆类型已存在,请勿重复添加 200012 车牌号已存在,请勿重复添加 200014 驾驶员已存在,请勿重复添加 200016 车型已绑定车辆,请勿删除 4.5 登记备案 4.5.1 接口名称 登记备案接口。 4.5.2 接口描述 开放平台创建授权账户。 4.5.3 接口范式 POST:http:/user/create 4.5.4 请求参数 登记备案的请求参数见表4。 表4 登记备案请求参数 参数 类型 最大长度 说明 userName String 20 用户名称,字母数字下划线 phone String 11 用户号码 DB34/T 34982019 4 表 4(续) 参数 类型 最大长度
9、 说明 email String 50 用户邮箱 organName String 50 单位名称 applicationId String 20 用户所属应用ID,没有可不传 customerType String 20 用户类型,没有可不传 address String 200 用户地址 uniqueCode String 20 用户编码,没有可不传 4.5.5 返回参数 登记备案返回参数见表5。 表5 登记备案返回参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识:success成功,fail失败 code String 返回
10、信息提示码 accessKey String 用户标识 securityKey String 用户秘钥 organId String 用户单位Id 5 用户平台接口 第三方通过 HTTP 协议提交 POST 请求调用开放平台的服务接口向用户平台传递数据。 接口请求调 用关系见图1。 第三方 开放平台(服务接口) 用户单位 部门 用户 车型 车辆 驾驶 员 订单 请求 图1 接口请求调用关系 5.1 用户单位 5.1.1 新增用户单位 5.1.1.1 接口名称 DB34/T 34982019 5 新增用户单位接口。 5.1.1.2 接口描述 在用户平台中新增用户单位,获取用户单位标识。 5.1.
11、1.3 接口范式 POST:http:/refactor/refactoringOrgan/addOrgan 5.1.1.4 请求参数 新增用户单位请求参数见表6。 表6 新增用户单位请求参数 参数 类型 最大长度 说明 organName String 50 用户单位名称 lawType String 根据枚举值确定 执法单位类型:一般机关单位 NONE,综合执法 COMPOSITELAW,执法执勤 DUTYLAE roleType String 根据枚举值确定 用户单位类型:用户平台 LOGISTICS,执法平台 LAW organType String 根据枚举值确定 用户单位子类型:
12、机关单位 GOVERMENT,事业单位 NATIONALAGENCY, 国有企业 NATIONALCOMPANY,一般企业单位 GENERALCOMPANY areaId String 20 地区 Id verticalSys String 20 垂直体系编码 organLevel Int 3 单位级别 customerServicePhone String 255 客服电话 licenceIssuingAuthority String 255 发证机关 characterOfInstitution String 255 单位性质 organCode String 20 单位内部代码 示例:
13、(参数) areaId: 0100124108104, characterOfInstitution: NATIONALAGENCY, customerServicePhone: 0551-XXXXXXX, lawType: NONE, licenceIssuingAuthority: , organCode: CX291XXX, organLevel: 3, organName: 安徽省某某事务管理局, organType: GOVERMENT, roleType: LOGISTICS, verticalSys: AGRICULTURE DB34/T 34982019 6 5.1.1.5 返
14、回参数 新增用户单位返回参数见表7。返回参数示例参见附录A。 表7 新增用户单位返回参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识:success成功,fail失败 code String 返回信息提示码 model String 用户单位Id(即organId) 5.1.2 修改用户单位 5.1.2.1 接口名称 修改用户单位接口。 5.1.2.2 接口描述 修改用户平台中用户单位信息。 5.1.2.3 接口范式 POST:http:/refactor/refactoringOrgan/editOrgan 5.1.2.4 请求
15、参数 修改用户单位请求参数见表8。 表8 修改用户单位请求参数 参数 类型 最大长度 说明 organId String 40 用户单位Id organName String 50 用户单位名称 lawType String 根据枚举值确定 执法单位类型:一般机关单位 NONE,综合执法 COMPOSITELAW,执法执勤 DUTYLAE roleType String 根据枚举值确定 用户单位类型:用户平台 LOGISTICS,执法平台 LAW organType String 根据枚举值确定 用户单位子类型:机关单位 GOVERMENT,事业单位 NATIONALAGENCY,国有企业 N
16、ATIONALCOMPANY,一般企 业单位 GENERALCOMPANY areaId String 20 地区 Id sortNo Int 3 排序值:不小于 0 的整数 verticalSys String 20 垂直体系编码 organLevel Int 3 单位级别 customerServicePhone String 255 客服电话 licenceIssuingAuthority String 255 发证机关 characterOfInstitution String 255 单位性质 organCode String 20 单位内部代码 DB34/T 34982019 7
17、示例:(参数) areaId: 0100124108101, characterOfInstitution: 机关单位, customerServicePhone: 0551-XXXXXXX, lawType: NONE, organCode: CX230XXX, organId: 79e0fe07b42542c7b928942011fxxxxx, organLevel: 3, organName: 安徽省某某技术局, organType: GOVERMENT, roleType: LOGISTICS, sortNo: 2418, verticalSys: AGRICULTURE 5.1.2.
18、5 返回参数 修改用户单位返回参数见表9。返回参数示例参见附录A。 表9 修改用户单位返回参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识:success 成功,fail 失败 code String 返回信息提示码 model String 返回空值 5.1.3 删除用户单位 5.1.3.1 接口名称 删除用户单位接口。 5.1.3.2 接口描述 删除用户平台中的用户单位信息。 5.1.3.3 接口范式 POST:http:/refactor/refactoringOrgan/deleteOrgan 5.1.3.4 请求参数 删
19、除用户单位请求参数见表10。 表10 删除用户单位请求参数 参数 类型 最大长度 说明 organId String 40 用户单位Id DB34/T 34982019 8 示例: (参数) organId: d620e4dbd3cf496580a89b89076xxxxx 5.1.3.5 返回参数 删除用户单位返回参数见表11。返回参数示例见附录A(资料性附录)。 表11 删除用户单位返回参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识:success 成功,fail 失败 code String 返回信息提示码 model S
20、tring 返回空值 5.2 部门接口 5.2.1 新增部门 5.2.1.1 接口名称 新增部门接口。 5.2.1.2 接口描述 在用户单位下创建部门,获取部门标识。 5.2.1.3 接口范式 POST:http:/refactor/refactoringDept/addDept 5.2.1.4 请求参数 新增部门请求参数见表12。 表12 新增部门请求参数 参数 类型 最大长度 说明 organId String 40 用户单位 Id deptName String 40 部门名称 sortNo String 128 排序值:不小于 0 的整数 示例: (参数) deptName: 肥西某某
21、局, organId: d620e4dbd3cf496580a89b0cfcfxxxxx, sortNo: 2202 DB34/T 34982019 9 5.2.1.5 返回参数 新增部门返回参数见表13。返回参数示例参见附录A。 表13 新增部门返回参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识:success 成功,fail 失败 code String 返回信息提示码 model String 部门 Id 5.2.2 修改部门 5.2.2.1 接口名称 修改部门接口。 5.2.2.2 接口描述 修改用户单位下的部门信息。
22、5.2.2.3 接口范式 POST:http:/refactor/refactoringDept/editDept 5.2.2.4 请求参数 修改部门请求参数见表14。 表14 修改部门请求参数 参数 类型 最大长度 说明 organId String 40 用户单位 Id deptId String 40 部门 Id deptName String 128 部门名称 示例: (参数) deptId: fa1c7d7a16b94c99843011171a5xxxxx, deptName: 办公室, organId: 79e0fe07b42542c7b928942011fxxxxx, 5.2.2
23、.5 返回参数 修改部门返回参数见表15。返回参数示例参见附录A。 DB34/T 34982019 10 表15 修改部门返回参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识:success 成功,fail 失败 code String 返回信息提示码 model String 返回空值 5.2.3 删除部门 5.2.3.1 接口名称 删除部门接口。 5.2.3.2 接口描述 删除用户单位中的部门信息。 5.2.3.3 接口范式 POST:http:/refactor/refactoringDept/deleteDept 5.2.
24、3.4 请求参数 删除部门请求参数见表16。 表16 删除部门请求参数 参数 类型 最大长度 说明 organId String 40 用户单位 Id deptId String 40 部门 Id 示例: (参数) organId: d620e4dbd3cf496580a89b89076xxxxx, deptId: 5e3ef66c87d84a4d9f474873jklxxxxx 5.2.3.5 返回参数 删除部门返回参数见表17。返回参数示例参见附录A。 表17 删除部门返回参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识:su
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB34 3498-2019 党政机关公务用车管理信息平台接口规范 3498 2019 党政机关 公务用车 管理 信息 平台 接口 规范
