河北省建设工程质量检测监管系统数据接口标准.docxVIP

PAGE PAGE 1 导言 1.1编写目的 本文档面向专业软件开发人员，本文档中定义了河北省检测机构软件系统与河北省建设工程质量检测监管系统之间数据对接的形式和内容，并为检测过程中工程数据下发、检测人员数据下发、检测设备数据下发检测原始记录上传和检测报告数据上传做了详细且严格的接口说明，使数据对接过程高效、稳定和安全的进行。 1.2参考资料 住建部：建设部令第141号《建设工程质量检测管理办法》 1.3术语 系统：本文特指河北省建筑工程质量检测监管系统； 检测项目编号：河北省建筑工程质量检测监管系统编制项目编号； 工程监督编号：建设单位在行政主管部门办理工程报监业务所产生的编号； 唯一标识：河北省建筑工程质量检测监管系统生成的检测报告唯一标识，并下发给检测机构管理信息系统保存。 1.4变更记录 版本号 修改内容 内容确认人 2.0 河北省建设工程质量检测监管系统数据接口标准 段英华 数据接口整体说明 2.1总体结构 平台数据上传下载总体结构和包含接口功能如下图所示： 2.2接口说明 河北省建筑工程质量检测监管系统接口基于HTTP协议的RESTful设计风格，采用JSON格式作为数据载体，访问客户端需通过OAUTH2认证来获取系统数据权限。 网络要求：可通过互联网访问河北省建筑工程质量检测监管系统接口，保证网络通畅。 软件要求：检测机构管理信息系统需支持RESTful接口调用，并实现接口所有要求。  数据接口详细说明 本节介绍如何获取系统Token以及登录超期刷新Token的接口，是进行数据上传下发的基础。 3.1获取数据权限说明 3.1.1获取Token 登录系统首先需要通过获取系统Token来得到当前检测机构在系统的数据上传下发权限。 接口地址 http://IP:9999/auth/oauth/Token?grant_type=password 业务参数 参数说明 参数名称 参数类型 参数描述 Header设置 Authorization：Basic dGVzdDp0ZXN0 提交方式 GET请求，传入参数采用在Request的body中以x-www-form-urlencoded方式提交 传入参数 username String 系统提供给各检测机构的用户名 password String 系统提供给各检测机构的密码，经过AES加密后的字符串 scope String 固定填入 server 返回结果 access_Token为通行Token； refresh_Token为刷新Token； 主要关注这两项 json { ????access_Token:?e7699fde-4e7b-4ecd-8224-2cc002907b49, ????Token_type:?bearer, ????refresh_Token:?3899abc8-e9d6-4d30-a9f4-bc7fd7491303, ????expires_in:?43199, ????scope:?server, ????license:?made?by?newmoon, ????active:?true, ????user_info:?{ ????????id:?8, ????????deptId:?10, ????????phone: ????????avatar:?/admin/sys-file/xiongan/ee1250f0a6244ccc985d23566c512b01.jpg, ????????tenantId:?0, ????????username:?test, ????????password:?null, ????????enabled:?true, ????????accountNonExpired:?true, ????????credentialsNonExpired:?true, ????????accountNonLocked:?true, ????????authorities:?[ ????????????{ ????????????????authority:?ROLE_4 ????????????} ????????] ????} ｝ 备注： 其中测试用户的用户名为systest，密码为Abc@123456!，对密码进行AES加密的秘钥请单独联系系统运维人员获取，具体AES加密方法请参考附录6.3。 3.1.2刷新Token 系统设置的Token有效期是24小时，在超时后原有Token会失效，可用3.1.1中获取的refresh_Token调用此接口来刷新Token，同样也可以重新获取Token。 接口地址 http://IP:9999/auth/oauth/Token?gran