《党政机关公务用车管理信息平台接口规范-DB34_T3498-2019》由会员分享，可在线阅读，更多相关《党政机关公务用车管理信息平台接口规范-DB34_T3498-2019（30页珍藏版）》请在金锄头文库上搜索。
1、ICS 35.240L 70DB342019 - 12 - 25 发布2020 - 01 - 25 实施安徽省市场监督管理局发 布安徽省地方标准DB 34/T 34982019党政机关公务用车管理信息平台接口规范文稿版次选择Interface specification of management information platform for official vehicles of party and government organsIDB34/T 34982019前言本标准按照 GB/T 1.1-2009 给出的规则起草。本标准由安徽省机关事务管理局提出并归口。开放平台 open p
2、latform提供一系列计算机易识别的数据接口，以供第三方开发者使用的平台。4接口基本要求4.1 接口形式对开放平台的服务接口的访问采用唯一资源标识符（URL 网址），应通过 HTTP 协议提交 POST 请求的方式进行。4.2 接口安全认证4.2.1 签名认证调用方应在开放平台进行登记备案，登记备案时，开放平台为用户分配用户标识 accessKey。调用方调用开放平台的服务接口时对参数进行加密生成签名，签名以参数的形式传递，服务接口接收签名后进行签名验证。4.2.2 签名步骤签名步骤包括：a) 生成签名时,将分配的 accessKey 和当前时间 reqTime 加入到传递的参数中；1DB3
3、4/T 34982019党政机关公务用车管理信息平台接口规范1 范围本标准规定了党政机关公务用车管理信息平台接口的术语和定义、接口基本要求和用户平台接口。本标准适用于党政机关公务用车管理信息平台接口的设计与开发。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 5271.1信息技术 词汇 第1部分：基本术语3 术语和定义GB/T 5271.1 界定的以及下列术语和定义适用于本文件。3.14.4接口返回提示码接口返回提示码信息见表3。表3接口返回提示码2DB34
4、/T 34982019b) 将传递的参数(包括accessKey 和reqTime)按照参数名称key 从小到大排序,以&形式连接成字符串进行 URL 编码，将请求的 URI 进行 URL 编码后和参数字符串连接形成新字符串，并使用国密 SM3 算法进行加密生成 sign；c) 将生成的 sign 和其他参数一起传递。4.3 输入与输出4.3.1 公共输入参数调用方在访问开放平台的服务接口时公共输入参数见表1。表1公共输入参数参数类型说明accessKeyString标识开发者身份，由开放平台提供reqTimeString请求接口时的北京时间，格式为yyyy-MM-dd HH:mm:sssig
5、nString签名4.3.2 公共输出参数开放平台服务接口的公共输出参数信息见表2。表2公共输出参数参数类型说明messageString返回信息说明resultString返回成功与否标识：success成功，fail失败codeString返回信息提示码modelString返回具体数据信息code说明200成功601,602,603相关操作执行成功20000失败20001用户不存在20002缺失签名字段20003服务单位Id为空20004申请人信息不完整20013无服务单位20014签名验证失败20015请求时间过期20016请求时间不存在4.5 登记备案4.5.1 接口名称登记备案接口
6、。4.5.2 接口描述开放平台创建授权账户。4.5.3 接口范式POST:http:/user/create4.5.4 请求参数登记备案的请求参数见表4。表4登记备案请求参数3DB34/T 34982019表 3 （续）code说明280018accessKey不存在280023地区ID不存在280026单位名称不存在280030参数不存在280033没有权限进行该操作100000添加成功100001修改成功100002删除成功200000添加失败200001修改失败200002删除失败200032由于部门中存在用户,无法删除200031存在下级部门，请勿删除200030部门不存在200006
7、部门已存在，请勿重复添加200019手机号已经存在200045参数错误200011车辆类型已存在，请勿重复添加200012车牌号已存在，请勿重复添加200014驾驶员已存在，请勿重复添加200016车型已绑定车辆，请勿删除参数类型最大长度说明userNameString20用户名称,字母数字下划线phoneString11用户号码5用户平台接口第三方通过 HTTP 协议提交 POST 请求调用开放平台的服务接口向用户平台传递数据。接口请求调用关系见图1。开放平台（服务接口）用户单位车辆请求第三方部门驾驶员用户订单车型图1接口请求调用关系5.1用户单位5.1.1新增用户单位5.1.1.1接口名称
8、4DB34/T 34982019表 4（续）参数类型最大长度说明emailString50用户邮箱organNameString50单位名称applicationIdString20用户所属应用ID，没有可不传customerTypeString20用户类型，没有可不传addressString200用户地址uniqueCodeString20用户编码，没有可不传4.5.5返回参数登记备案返回参数见表5。表5登记备案返回参数参数类型说明messageString返回信息说明resultString返回成功与否标识：success成功，fail失败codeString返回信息提示码accessK
9、eyString用户标识securityKeyString用户秘钥organIdString用户单位Id示例：（参数）5areaId: 0100124108104,characterOfInstitution: NATIONALAGENCY, customerServicePhone: 0551-XXXXXXX, lawType: NONE, licenceIssuingAuthority: ,organCode: CX291XXX, organLevel: 3,organName: 安徽省某某事务管理局, organType: GOVERMENT, roleType: LOGISTICS,
10、verticalSys: AGRICULTUREDB34/T 34982019新增用户单位接口。5.1.1.2 接口描述在用户平台中新增用户单位，获取用户单位标识。5.1.1.3 接口范式POST:http:/refactor/refactoringOrgan/addOrgan5.1.1.4 请求参数新增用户单位请求参数见表6。表6新增用户单位请求参数参数类型最大长度说明organNameString50用户单位名称lawTypeString根据枚举值确定执法单位类型：一般机关单位 NONE，综合执法COMPOSITELAW，执法执勤 DUTYLAEroleTypeString根据枚举值确定用
11、户单位类型：用户平台 LOGISTICS，执法平台 LAWorganTypeString根据枚举值确定用户单位子类型：机关单位 GOVERMENT，事业单位 NATIONALAGENCY， 国有企业 NATIONALCOMPANY，一般企业单位GENERALCOMPANYareaIdString20地区 IdverticalSysString20垂直体系编码organLevelInt3单位级别customerServicePhoneString255客服电话licenceIssuingAuthorityString255发证机关characterOfInstitutionString255单位
12、性质organCodeString20单位内部代码5.1.2.4请求参数修改用户单位请求参数见表8。表8修改用户单位请求参数6DB34/T 349820195.1.1.5 返回参数新增用户单位返回参数见表7。返回参数示例参见附录A。表7新增用户单位返回参数参数类型说明messageString返回信息说明resultString返回成功与否标识：success成功，fail失败codeString返回信息提示码modelString用户单位Id(即organId)5.1.2 修改用户单位5.1.2.1 接口名称修改用户单位接口。5.1.2.2 接口描述修改用户平台中用户单位信息。5.1.2.3
13、 接口范式POST:http:/refactor/refactoringOrgan/editOrgan参数类型最大长度说明organIdString40用户单位IdorganNameString50用户单位名称lawTypeString根据枚举值确定执法单位类型：一般机关单位 NONE，综合执法COMPOSITELAW，执法执勤 DUTYLAEroleTypeString根据枚举值确定用户单位类型：用户平台 LOGISTICS，执法平台 LAWorganTypeString根据枚举值确定用户单位子类型：机关单位 GOVERMENT，事业单位NATIONALAGENCY，国有企业 NATIONALCOMPANY，一般企业单位 GENERALCOMP
