ICS 35.240 L 70 DB34 安 徽 省 地 方 标 准 DB 34/T 3498—2019 党政机关公务用车管理信息平台接口规范 Interface specification of management information platform for official vehicles of party and government organs 文稿版次选择 2019 - 12 - 25 发布 安徽省市场监督管理局 2020 - 01 - 25 实施 发 布 DB34/T 3498—2019 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。 本标准由安徽省机关事务管理局提出并归口。 本标准起草单位：安徽省机关事务管理局、安徽中科美络信息技术有限公司、安徽省质量和标准化 研究院、中国科学院合肥物质科学研究院、合肥市机关事务管理局、芜湖市机关事务管理局、马鞍山市 机关事务管理中心、滁州市机关事务管理局、宣城市机关事务管理局。 本标准主要起草人：陶钧、邹月明、黄晓芳、周献志、佟杰、邢鹏、尚春、潘勤华、李广胜、李骏、 刘罡、郑云卿、吴仲城、罗健飞、张文秋 、武理芬、王碧菁、王学永、戴朋龙、付应翠。 I DB34/T 3498—2019 党政机关公务用车管理信息平台接口规范 1 范围 本标准规定了党政机关公务用车管理信息平台接口的术语和定义、接口基本要求和用户平台接口。 本标准适用于党政机关公务用车管理信息平台接口的设计与开发。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 5271.1 信息技术 词汇 第1部分：基本术语 3 术语和定义 GB/T 5271.1 界定的以及下列术语和定义适用于本文件。 3.1 开放平台 open platform 提供一系列计算机易识别的数据接口，以供第三方开发者使用的平台。 4 接口基本要求 4.1 接口形式 对开放平台的服务接口的访问采用唯一资源标识符（URL 网址），应通过 HTTP 协议提交 POST 请 求的方式进行。 4.2 接口安全认证 4.2.1 签名认证 调用方应在开放平台进行登记备案，登记备案时，开放平台为用户分配用户标识 accessKey。调用 方调用开放平台的服务接口时对参数进行加密生成签名，签名以参数的形式传递，服务接口接收签名后 进行签名验证。 4.2.2 签名步骤 签名步骤包括： a) 生成签名时,将分配的 accessKey 和当前时间 reqTime 加入到传递的参数中； 1 DB34/T 3498—2019 将传递的参数(包括 accessKey 和 reqTime)按照参数名称 key 从小到大排序,以&形式连接成字 符串进行 URL 编码，将请求的 URI 进行 URL 编码后和参数字符串连接形成新字符串，并使用国 密 SM3 算法进行加密生成 sign； 将生成的 sign 和其他参数一起传递。 b) c) 4.3 输入与输出 4.3.1 公共输入参数 调用方在访问开放平台的服务接口时公共输入参数见表1。 表1 参数 公共输入参数 类型 说明 accessKey String 标识开发者身份，由开放平台提供 reqTime String 请求接口时的北京时间，格式为yyyy-MM-dd HH: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 请求时间不存在 2 DB34/T 3498—2019 表 3 （续） code 说明 280018 accessKey不存在 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 参数 类型 登记备案请求参数 最大长度 说明 userName String 20 用户名称,字母数字下划线 phone String 11 用户号码 3 DB34/T 3498—2019 表 4（续） 参数 类型 最大长度 说明 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 返回信息提示码 accessKey String 用户标识 securityKey String 用户秘钥 organId String 用户单位Id 5 用户平台接口 第三方通过 HTTP 协议提交 POST 请求调用开放平台的服务接口向用户平台传递数据。接口请求调 用关系见图1。   请求 第三方  开放平台（服务接口）  用户单位   车辆     部门 驾驶员   用户  订单   车型 图1 5.1 用户单位 5.1.1 5.1.1.1 4 新增用户单位 接口名称 接口请求调用关系     DB34/T 3498—2019 新增用户单位接口。 5.1.1.2 接口描述 在用户平台中新增用户单位，获取用户单位标识。 5.1.1.3 接口范式 POST:http://…/refactor/refactoringOrgan/addOrgan 5.1.1.4 请求参数 新增用户单位请求参数见表6。 表6 参数 类型 新增用户单位请求参数 最大长度 organName String 50 lawType String 根据枚举值确定 roleType String 根据枚举值确定 说明 用户单位名称 执法单位类型：一般机关单位 NONE，综合执法 COMPOSITELAW，执法执勤 DUTYLAE 用户单位类型：用户平台 LOGISTICS，执法平台 LAW 用户单位子类型： organType String 根据枚举值确定 机关单位 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 单位内部代码 示例：（参数） { "areaId": "0100124108104", "characterOfInstitution": "NATIONALAGENCY", "customerServicePhone": "0551-XXXXXXX", "lawType": "NONE", "licenceIssuingAuthority": "", "organCode": "CX291XXX", "organLevel": "3", "organName": "安徽省某某事务管理局", "organType": "GOVERMENT", "roleType": "LOGISTICS", "verticalSys": "AGRICULTURE" } 5 DB34/T 3498—2019 5.1.1.5 返回参数 新增用户单位返回参数见表7。返回参数示例参见附录A。 表7 参数 新增用户单位返回参数 类型 说明 message String 返回信息说明 result String 返回成功与否标识：success成功，fail失败 code String 返回信息提示码 model String 用户单位Id(即organId) 5.1.2 修改用户单位 5.1.2.1 接口名称 修改用户单位接口。