DB34∕T 3498-2019 党政机关公务用车管理信息平台接口规范(安徽省).pdf
《DB34∕T 3498-2019 党政机关公务用车管理信息平台接口规范(安徽省).pdf》由会员分享,可在线阅读,更多相关《DB34∕T 3498-2019 党政机关公务用车管理信息平台接口规范(安徽省).pdf(32页珍藏版)》请在咨信网上搜索。
1、TCS 35.240 L 70 DB34.l-.文徽省山巳ET且,万标准DB 34/T 3498-2019 党政机关公务用车管理信息平台接口规范Interface specification of management information platform for official vehicles of party and govemment organs 2019-12-25发布2020-01-25实施安徽省市场监督管理局发布目IJ1=1 本标准按照四月1.1-2009给出的规则起草。本标准由安徽省机关事务管理局提出并归口。DB34/T 3498-2019 本标准起草单位:安徽省机关事
2、务管理局、安徽中科美络信息技术有限公司、安徽省质量和标准化研究院、中国科学院合肥物质科学研究院、合肥市机关事务管理局、芜湖市机关事务管理局、马鞍山市机关事务管理中心、;除外|市机关事务管理局、宣城市机关事务管理局。本标准主要起草人:陶钧、邹月明、黄晓芳、周献志、佟杰、邢鹏、尚春、潘勤华、李广胜、李骏、刘置、郑云卿、吴仲城、罗健飞、张文秋、武理芬、王碧菁、王学永、戴朋龙、付应翠。DB34/T 3498-2019 党政机关公务用车管理信息平台接口规范1 范围本标准规定了党政机关公务用车管理信息平台接口的术语和定义、接口基本要求和用户平台接口。本标准适用于党政机关公务用车管理信息平台接口的设计与开发
3、。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,叉所注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 527l.1 信息技术词汇第l部分:基本术语3 术语和定义GB/T 527l.1界定的以及下列术语和定义适用于本文件。3.1 开放平台openplatform 提供一系列计算机易识别的数据接口,以供第二万开发者使用的平台O4 接口基本要求4.1 接口形式对开放平台的服务接口的访问采用唯一资源标识符(URL网址),应通过HTTP协议提交POST请求的方式进行。4.2 接口安全认证4.2.1 签名认证调用方应在开
4、放平台进行登记备案,登记备案时,开放平台为用户分配用户标识accessKeyo调用方调用开放平台的服务接口时对参数进行加密生成签名,签名以参数的形式传递,服务接口接收签名后进行签名验证。4.2.2 签名步骤签名步骤包括:a)生成签名时,将分配的accessKey和当前时间reqTime加入到传递的参数中:DB34/T 3498-2019 b)将传递的参数(包括accessKey和reqTime)按照参数名称key从小到大排序,以&形式连接成宇符串进行URL编码,将请求的URI进行URL编码后和参数字符串连接形成新字符串,并使用国密SM3算法进行加密生成sig口:c)将生成的sign和其他参数一
5、起传递。4.3 输入与输出4.3.1 公共输入参数调用方在访问开放平台的服务接口时公共输入参数见表10表1公共输入参数参数类型accessKev String 标识开发者身份,由开放半台提供说明reqTime String 请求接口时的北京时间,格式为yyyy-MM-ddHH:mm:ss slgn String 签名4.3.2 公共输出参数开放平台服务接口的公共输出参数信息、见表20表2公共输出参数参数类型说明message String 返回信息说明resu1t String 返|门|成功与否标识succ巳ss成功,fai1失败code String 远|口|信息提示码mode1 Strin
6、日返问具体数据信息4.4 接口返回提示码接口返回提示码信息、见表30表3接口返回提示码code 说明200 成功601,602,603 相关操作执行成功20000 失败20001 J+j户不存在20002 缺失签名字段20003 服务单位Id为空20004 申请人信息不完整20013 为服务单位20014 签名验证失败20015 请求时间过期20016 请求时间不存在2 DB34/T 3498-2019 表3(续)code 说明280018 accessKev不存在280023 地区ID不存在280026 单位名称不存在280030 参数不存在280033 没有权限进行该操作100000 添加
7、|成功100001 修改成功100002 删除成功200000 添加失败200001 修改失败200002 删除失败200032 由于部门中存在用户,无法删除200031 存在下级部门,请勿删除200030 部门不存在200006 部门己存在,请勿重复添加200019 子机号己经存在20004.5 参数错误200011 车辆类型己存在,请勿重复添加200012 车牌号己存在,请勿重复添加200014 驾驶员己存在,请勿重复添加200016 车型己绑定车辆,请勿删除4.5 登记备案4.5.1 接口名称登记备案接口。4.5.2 接口描述开放平台创建授权账户。4.5.3 接口范式POST:http:
8、/./user/create 4.5.4 请求参数登记备案的请求参数见表40参数类型数一参求一请案一王瑞一町、-TL,一IIf登一最A斗一表一H凡rrbl 说userName String String 20 11 用户名称,宁母数宁下划线用户号码phone 3 DB34/T 3498-2019 表4(续)参数类型最大长度说明email String 50 时户邮箱organName String 50 单位名称applicationId String 20 用户所属应用ID,没有可不传customerType String 20 用户类型,没有可不传address String 200 用户
9、地址uniqueCode String 20 用户编码,没有可不传4.5.5 返回参数登记备案返回参数见表50表5登记备案返回参数参数类型说明message String 返回信息说明result Stri日g返回成功与否标识success成功,fail失败code Stri日g返回信息提示码accessK巳VStri日g时户标识securityKey String 用户秘钥organId String 用户单位Id5 用户平台接口第三方通过HTTP协议提交POST请求调用开放平台的服务接口向用户平台传递数据。接口请求调用关系见图l。5.1 用户单位5.1.1 新增用户单位5.1.1.1 接口
10、名称4 第二方图1接口请求调用关系DB34/T 3498-2019 新增用户单位接口。5.1.1.2 接口描述在用户平台中新增用户单位,获取用户单位标识。5.1.1.3 接口范式POST:http:/./refactor/refactoringOrgan/addOrgan 5.1.1.4 请求参数新增用户单位请求参数见表60表6新增用户单位请求参数参数类型最大长度organName String 50 lawType Stri日g根据枚举值确定roleType String 根据枚举值确定organType String 根据枚举值确定areald String 20 verticalSys
11、String 20 organLevel Int 3 customerServicePhone String 25.5 licenceIssuingAuthority String 25.5 characterOflnstitution String 25.5 organCode String 20 示例:(参数)areald:0100124108104,characterOflnstitution:NATIONALAGENCY 飞customerServicePhone:0551-XXXXXXX I aw T ype:NONE,I i cence I ssu i ngAuthor i ty
12、organCode:CX291XXX,or ganLeve I:3,organName:安徽省某某事务管理局or gan Type:GOVERMENT,roleType:LOGISTICS,verticaISys田AGRICULTURE说明用户单位名称执法单位类型:一般机关单位NONE,综合执法COMPOSITELAW,执法执勤DUTYLAE用户单位类型:用户平台LOGISTICS,执法平台LAWJ+J户单位于类型:机关单位GOVERMENT,事业单位NATI ONALAGENCY,同有企业NATI ONALCOMPANY,一般企业单位GENERALCOMPANY 地区Id垂直休系编码单位级圳
13、客服电话发证机关单位性质单位内部代码5 DB34/T 3498-2019 5.1.1.5 返回参数新增用户单位返回参数见表7。返回参数示例参见附录Ao参数-l开i1message String result String code String model String 5.1.2 修改用户单位5.1.2.1 接口名称修改用户单位接口O5.1.2.2 接口描述表7新增用户单位返回参数说明返回信息说明返回成功与否标识success成功,fail失败返回信息提示码用户单位Id(即organld)修改用户平台中用户单位信息。5.1.2.3 接口范式POST:http:/./refactor/refa
14、ctoringOrgan/editOrgan 5.1.2.4 请求参数修改用户单位请求参数见表8。表8修改用户单位请求参数参数类型最大长度说明organld String 40 用户单位IdorganName String 50 用户单价名称lawType String 根据枚举值确定执法单价类型:一般机关单位NONE,综合执法COMPOS ITELA W,执法执勤DUTYLAEroleType String 根据枚举值确定用户单位类型:用户平台LOGISTICS,执法平台LAW用户单位子类型:机关单位GOVERMENT,事业单位organType String 根据枚举值确迄NA TI ON
15、ALAGENCY,国有企业NATIONALCOMPANY,一般介业单位GENERALCOMPANYareald String 20 地区IdsortNo Int 3 排序值:小小于O的整数verticalSvs String 20 垂直休系编码organLevel Int 3 单位级别customerServicePhone String 255 客服电话licenceIssuingAuthority String 255 发证机关characterOflnstitution String 255 单位性质organCode String 20 单位内部代码6 DB34/T 3498-2019
16、 示例参数areald:0100124108101 characterOflnstitution:机关单位customerServicePhone:0551-XXXXXXX I aw T ype:NONE,organCode:CX230XXX organ I d:7geOfe07b42542c7b928942011 fxxxxx,or ganLeve I:3,、rganName:安徽省某某技术局organType:GOVERMENT roleType:LOGISTICS sortNo目2418,vert i ca I Sys:AGR I CULTURE 5.1.2.5 返回参数修改用户单位返回
17、参数见表9。返回参数示例参见附录Ao表9修改用户单位返回参数参数类型说明message String 返|门|信息说明result String 返回成功与否标识succ巳ss成功,fail失败code String 返回信息提示码model String 返回空信5.1.3 删除用户单位5.1.3.1 接口名称删除用户单位接口O5.1.3.2 接口描述删除用户平台中的用户单位信息。5.1.3.3 接口范式POST:http:/./refactor/refactoringOrgan/deleteOrgan 5.1.3.4 请求参数删除用户单位请求参数见表10。表10删除用户单位请求参数参数类型
18、最大长度日川rrbl 说organld String 40 用户单位Id7 DB34/T 3498-2019 示例参数)organld:d620e4dbd3cf496580a89b89076xxxxx 5.1.3.5 返回参数删除用户单位返回参数见表110返回参数示例见附录A(资料性附录L表11删除用户单位返回参数参数类型说明message String 返回信息说明result String 返问成功与否标识success成功,fail失败code String model String 5.2 部门接口5.2.1 新增部门5.2.1.1 接口名称新增部门接口。5.2.1.2 接口描述返回信
19、息提示码返回空值在用户单位下创建部门,获取部门标识。5.2.1.3 接口范式POST:http:/./refactor/refactoringDept/addDept 5.2.1.4 请求参数新增部门请求参数见表120表12新增部门请求参数参数类型最大长度organld Stri日g40 deptName String 40 用户单位Id部门名称说明sortNo String 128 排序值:不小于0的整数8 示例参数)deptName:巴西某某局organld田d620e4dbd3cf496580a89bOcfcfxxxxx,sortNo:2202 DB34/T 3498-2019 5.2.
20、1.5 返回参数新增部门返回参数见表130返回参数示例参见附录A。表13新增部门返回参数参数类型说明message String 返回信息说明resu1t String 返回成功与否标识success成功,fai1失败code mode1 5.2.2 修改部门5.2.2.1 接口名称修改部门接口。5.2.2.2 接口描述String String 修改用户单位下的部门信息O5.2.2.3 接口范式返回信息提示码部门IdPOST:http:/./refactor/refactoringDept/editDept 5.2.2.4 请求参数修改部门请求参数见表140表14修改部门请求参数参数类型最大
21、长度organId String 40 deptId String 40 deptName String 128 示例:(参数)d巳ptld:fa1c7d7a16b94c99843011171a5xxxxx d由eptNam阳n附l旧e:办公室 organ I d:7geOfe07b42542c7b928942011 fxxxxx,5.2.2.5 返回参数修改部门返回参数见表150返回参数示例参见附录A。说明用户单位Id部门Id部门名称9 DB34/T 3498-2019 表15修改部门返回参数参数类型说明message Strin日返回信息说明result Strin日返回成功与否标识suc
22、cess成功,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.3.4 请求参数删除部门请求参数见表160参数类型数参一求一请-1一-|-W民V一主日一牛,余-J!nHHVE-4、-/X Hq-t 册一大一最zo-表一说明organld String String 40 40 用户单位Id部门IddeptId 示例参数)o
23、rgan I d:d620e4dbd3cf496580a89b89076xxxxx,deptld:5e3ef66c87d84a4d9f474873jklxxxxx 5.2.3.5 返回参数删除部门返回参数见表170返回参数示例参见附录A。表17删除部门返回参数最f主!J1j(类型说明message Strin日返回信息说明result Strin日返回成功与否标识success成功,fail失败code Strin日返回信息提示码model String 返回空值5.3 用户接口10 5.3.1 新增用户5.3.1.1 接口名称新增用户接口。5.3.1.2 接口描述在用户单位和部门下创建用户,
24、获取用户标识。5.3.1.3 接口范式POST:http:/./refactor/refactoringUser/addUser 5.3.1.4 请求参数新增用户请求参数见表180DB34/T 3498-2019 表18新增用户请求参数参数类型届大长度organld String 10 deptId String 10 realName String 20 username String 50 password Strin日255 phone String 11 areald String 20 status String 根据枚举值确立isMajor String 根据枚举值确定sortNo
25、 Int 3 示例参数)areald:0100124110102,deptld:5e3ef66c87d84a4d9f474873ec9xxxxx,i sMajor:YES organ I d:7a9d1 e80afe64855a55f795a735xxxxx,password:563eef3955cf425dbbb8cb082dexxxxx phone:1818766xxxx re臼alNam阳e:张某某sortNo:1171 status:USEABLE、sername:xc某某用户名审批H5.3.1.5 返回参数新增用户返回参数见表190返回参数示例参见附录A。说明用户单位Id部门Id五实
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB34T 3498-2019 党政机关公务用车管理信息平台接口规范安徽省 DB34 3498 2019 党政机关 公务用车 管理 信息 平台 接口 规范 安徽省
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。