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

ICS 35.240 L 70 DB34 2019 2019 - 12 - 25 发布 2020 - 01 - 25 实施 安徽省市场监督管理局 发 布 安 徽 省 地 方 标 准 DB 34/T 3498—2019 党政机关公务用车管理信息平台接口规范 文稿版次选择Interface specification of management information platform for official vehicles of party and government organs 文稿版次选择 IDB34/T 3498—2019 I 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。本标准由安徽省机关事务管理局提出并归口。 开放平台 open platform提供一系列计算机易识别的数据接口，以供第三方开发者使用的平台。4 开放平台 open platform 提供一系列计算机易识别的数据接口，以供第三方开发者使用的平台。 4 接口基本要求 接口形式 对开放平台的服务接口的访问采用唯一资源标识符（URL 网址），应通过 HTTP 协议提交 POST 请求的方式进行。 接口安全认证 签名认证 调用方应在开放平台进行登记备案，登记备案时，开放平台为用户分配用户标识 accessKey。调用方调用开放平台的服务接口时对参数进行加密生成签名，签名以参数的形式传递，服务接口接收签名后进行签名验证。 签名步骤 签名步骤包括： 生成签名时,将分配的 accessKey 和当前时间 reqTime 加入到传递的参数中； 1 党政机关公务用车管理信息平台接口规范 范围 本标准规定了党政机关公务用车管理信息平台接口的术语和定义、接口基本要求和用户平台接口。本标准适用于党政机关公务用车管理信息平台接口的设计与开发。 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 5271.1 信息技术 词汇 第1部分：基本术语 术语和定义 GB/T 5271.1 界定的以及下列术语和定义适用于本文件。 4.4 接口返回提示码接口返回提示码信息见表 4.4 接口返回提示码 接口返回提示码信息见表3。 表3 接口返回提示码 2 将传递的参数(包括accessKey 和reqTime)按照参数名称key 从小到大排序,以形式连接成字符串进行 URL 编码，将请求的 URI 进行 URL 编码后和参数字符串连接形成新字符串，并使用国密 SM3 算法进行加密生成 sign； 将生成的 sign 和其他参数一起传递。 输入与输出 公共输入参数 调用方在访问开放平台的服务接口时公共输入参数见表1。 表1 公共输入参数 参数 类型 说明 accessKey String 标识开发者身份，由开放平台提供 reqTime String 请求接口时的北京时间，格式为yyyy-MM-dd HH:mm:ss sign String 签名 公共输出参数 开放平台服务接口的公共输出参数信息见表2。 表2 公共输出参数 参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识：success成功，fail失败 code String 返回信息提示码 model String 返回具体数据信息 code 说明 200 成功 601,602,603 相关操作执行成功 20000 失败 20001 用户不存在 20002 缺失签名字段 20003 服务单位Id为空 20004 申请人信息不完整 20013 无服务单位 20014 签名验证失败 20015 请求时间过期 20016 请求时间不存在 登记备案接口名称登记备案接口。接口描述 登记备案 接口名称 登记备案接口。 接口描述 开放平台创建授权账户。 接口范式 POST:http://…/user/create 请求参数 登记备案的请求参数见表4。 表4 登记备案请求参数 3 表 3 （续） code 说明 280018 accessKey不存在 280023 地区ID不存在 280026 单位名称不存在 280030 参数不存在 280033 没有权限进行该操作 100000 添加成功 100001 修改成功 100002 删除成功 200000 添加失败 200001 修改失败 200002 删除失败 200032 由于部门中存在用户,无法删除 200031 存在下级部门，请勿删除 200030 部门不存在 200006 部门已存在，请勿重复添加 200019 手机号已经存在 200045 参数错误 200011 车辆类型已存在，请勿重复