# 运维管理平台v3.0接口文档 ## 全局说明: ### 何时该需要授权说明 ``` 当响应内容中 respCode 为 A0301 时,web端应重定向到登录页面,进行登录 API接口直接调用时,需先请求获取OpenId(目前为账号ID)的接口,再根据此OpenId获取token,再进行相关业务接口请求 { "respCode": "A0301", //响应码 "respMsg": "访问未授权" //响应描述 } ``` ### 网关响应码说明 ``` "A0301", "访问未授权" "A0135", "Method Not Allowed" "A0340", "签名异常" 后续加入加解密异常的响应信息说明 ``` ### 业务响应body说明 ``` 所有接口的有效响应信息都包括respCode、respMsg两个字段,正常响应可能包含content、count等字段内容,如下所示: { // 实际响应的数据体,可能是数组,也可能是对象json体,但是一个接口的响应格式是固定的,单接口要么是数组,要么是对象json体,不一定存在此content属性 "content": { // 单条新增数据的接口,这里的值可能代表新增记录的ID值 "test":"123" }, "count":1, //响应体的总数大小,分页查询时,代表总记录数大小 "respCode": "00000", //响应码 "respMsg": "success" //响应描述 } 其中respCode只有为"00000"代表成功,其余均为失败;具体失败码,所对应的描述信息会动态变化(但是每一个接口同一个失败信息对应的respCode不会改变),实际错误信息以respMsg的展示信息为准,所以这里并不给出respCode的各种定义; 是否响应成功的判断均以respCode是否为"00000"进行判断。 ``` ## 登录 ### 账号登录 URL:http://develop.persagy.com/integrated-platform/saas-account/saas/login Method:POST Header:Content-Type=application/json 请求: { "appId":"PC", //登录端,PC-电脑,APP-手机应用端,必填,作为sql条件 "username":"zhangsan", // 账号登录名,必填 "password":"123456", // 账号密码,必填 "remember":false, // 是否记住登录,true-记住,默认false,选填 "auths":false, // 是否获取此账号对应的菜单权限树,true-获取,默认false,选填 "redirectUrl":"https://www.baidu.com", //登录成功后的重定向链接,选填;当为空时,正常登陆,否则重定向到此地址(会经过URLEncoder编码) "clientId":"123", // 客户端ID,选填 "state":"456" // 客户端自定义状态信息,选填 } 返回: header: token: 31430ad51b0bd1ac1661697cefd0c5b1c66dd8ba382cc33392974cc138dea908.F4B702C0FE3AE2F8DCE6443B434BD26E #格式:账号信息.token body: { "content": { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号 "accountSource": "persagy", //账号来源 "accountType": "0", //账号类型, 0-超级管理员(所有集团),1-单集团管理员(单集团),2-普通账号 "appId": "PC", "createTime": 1615795130000, "groupCode": "TEST", //集团编码 "headPortrait": "http://127.0.0.1:8080/test.img", //账号头像 "id": "1371370289309515777", //账号ID "lastLoginIp": "127.0.0.1", //上次登录IP "lastLoginTime": 1615797523000, //上次登录时间 "mail": "18888888888@16a3.com", //邮箱 "phoneNum": "18888888888", //手机号 "remark": "账号备注信息", //备注信息 "updateTime": 1615795607000, "updateUser": "1371370289309515777", "username": "zhangsan", //账号登录名 "valid": 1, //1-有效,0-无效 "validEndTime": 1899791706000, //账号有效期结束时间 "validStartTime": 1615720476000, //账号有效期开始时间 "validLast": "0" //账号期限限制,0-期内有效,1-永久有效 }, "respCode": "00000", "respMsg": "success" } ### 记住登录 URL:http://develop.persagy.com/integrated-platform/saas-account/saas/remember Method:POST Header:Content-Type=application/json 请求: body: { "appId":"PC", //登录端,PC-电脑,APP-手机应用端,必填,作为sql条件 "username":"zhangsan", //账号用户名,必填 "accountId":"AC1372371635352403969" //账号ID,必填 } 返回: header: token: 31430ad51b0bd1ac1661697cefd0c5b1c66dd8ba382cc33392974cc138dea908.F4B702C0FE3AE2F8DCE6443B434BD26E #格式:账号信息.token body: { "content": { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号 "accountSource": "persagy", //账号来源 "accountType": "0", //账号类型, 0-超级管理员(所有集团),1-单集团管理员(单集团),2-普通账号 "appId": "PC", "createTime": 1615795130000, "groupCode": "TEST", //集团编码 "headPortrait": "http://127.0.0.1:8080/test.img", //账号头像 "id": "1371370289309515777", //账号ID "lastLoginIp": "127.0.0.1", //上次登录IP "lastLoginTime": 1615797523000, //上次登录时间 "mail": "18888888888@16a3.com", //邮箱 "phoneNum": "18888888888", //手机号 "remark": "账号备注信息", //备注信息 "updateTime": 1615795607000, "updateUser": "1371370289309515777", "username": "zhangsan", //账号登录名 "valid": 1, //1-有效,0-无效 "validEndTime": 1899791706000, //账号有效期结束时间 "validStartTime": 1615720476000, //账号有效期开始时间 "validLast": "0" //账号期限限制,0-期内有效,1-永久有效 }, "respCode": "00000", "respMsg": "success" } ### 退出登录 URL:http://develop.persagy.com/integrated-platform/saas-account/account/logout Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969" //账号ID,必填 } 返回: { "respCode": "00000", "respMsg": "退出成功" } ## 集团管理 ### 集团信息查询 URL:http://develop.persagy.com/integrated-platform/saas-account/group/querySaasGroupList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,作为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,选填 "groupName":"测试集团", //集团名称,支持模糊查询,选填 "deployModel":"0", //集团部署方式,0-公有云,1-私有云,选填 "syncState":"2" //数据同步状态,0-数据同步失败,1-数据同步成功,2-未同步,选填 } 返回: { "content": [ { "createTime": 1615793880000, "deployModel": "0", "groupCode": "TEST", "groupDesc": "测试集团", "groupIcon": "http://127.0.0.1:9999/test.img", "groupName": "测试集团", "remark": "集团备注信息", "syncState": "2", "updateTime": 1615793880000, "updateUser": "1371370289309515777", "valid": 1 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 查询集团项目树(权限过滤) URL:http://develop.persagy.com/integrated-platform/saas-account/group/queryGroupProjectTree Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,必填,作为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST" //集团编码,选填 } 返回: { "content": [ { "createTime": 1616054480000, "deployModel": "0", "groupCode": "TEST", "groupDesc": "测试集团", //集团描述 "groupIcon": "http://127.0.0.1:9999/test.img", //集团图标 "groupName": "测试集团", //集团名称 "projects": [ //下级项目集合 { "areaId": "AR1372447231903342594", "createTime": 1616052043000, "groupCode": "TEST", "id": "PR1372447859102785538", "projectId": "Pj1209010205", "projectLocalId": "1209010205", "projectName": "测试项目05", "remark": "项目备注信息05", "updateTime": 1616203558000, "updateUser": "AC1372371635352403969", "valid": 1 } ], "remark": "集团备注信息", "syncState": "2", "updateTime": 1616054480000, "updateUser": "AC1372371635352403969", "valid": 1 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 创建集团信息 URL:http://develop.persagy.com/integrated-platform/saas-account/group/createSaasGroup Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,必填 "groupName":"测试集团", //集团名称,必填 "deployModel":"0", //集团部署方式,0-公有云,1-私有云,选填 "groupIcon":"http://127.0.0.1:9999/test.img", // 集团图标,选填 "groupDesc":"测试集团", // 集团描述,选填 "remark":"集团备注信息" // 备注,选填 } 返回: { "respCode": "00000", "respMsg": "保存成功" } ### 更新集团信息 URL:http://develop.persagy.com/integrated-platform/saas-account/group/updateSaasGroup Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,必填 "groupName":"测试集团", //集团名称,必填 "deployModel":"0", //集团部署方式,0-公有云,1-私有云,必填 "groupIcon":"http://127.0.0.1:9999/test.img", // 集团图标,选填 "groupDesc":"测试集团", // 集团描述,选填 "remark":"集团备注信息" // 备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ## 区域管理 ### 查询区域树(全局) URL:http://develop.persagy.com/integrated-platform/saas-account/area/querySaasAreaTree Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"zhangsan", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST" //集团编码,选填 } 返回: { "content": [ { "areaCode": "1001", //区域编码 "areaName": "一级区域-01", //区域名称 "areaType": "0", //区域类别,0-非最底层区域,1-最底层区域 "childrens": [], //下级区域集合 "createTime": 1615945924000, "groupCode": "TEST", "id": "AR1372002764192866305", //区域ID "parentId": "", //上级区域ID "remark": "一级区域-01", //备注 "updateTime": 1615945924000, "updateUser": "zhangsan" }, { "areaCode": "1002", "areaName": "一级区域-02", "areaType": "0", "childrens": [ { "areaCode": "100202", "areaName": "二级区域-02", "areaType": "0", "childrens": [], "createTime": 1615945988000, "groupCode": "TEST", "id": "AR1372003033744007169", "parentId": "AR1372002938164207618", "remark": "二级区域-02", "updateTime": 1615945988000, "updateUser": "zhangsan" }, { "areaCode": "100201", "areaName": "二级区域-01", "areaType": "0", "childrens": [ { "areaCode": "10020101", "areaName": "三级区域-01", "areaType": "1", "childrens": [], "createTime": 1615946017000, "groupCode": "TEST", "id": "AR1372003152283426817", "parentId": "AR1372003069462700033", "remark": "三级区域-01", "updateTime": 1615946017000, "updateUser": "zhangsan" }, { "areaCode": "10020102", "areaName": "三级区域-02", "areaType": "1", "childrens": [], "createTime": 1615946029000, "groupCode": "TEST", "id": "AR1372003203151945730", "parentId": "AR1372003069462700033", "remark": "三级区域-02", "updateTime": 1615946029000, "updateUser": "zhangsan" } ], "createTime": 1615945997000, "groupCode": "TEST", "id": "AR1372003069462700033", "parentId": "AR1372002938164207618", "remark": "二级区域-01", "updateTime": 1615945997000, "updateUser": "zhangsan" } ], "createTime": 1615945966000, "groupCode": "TEST", "id": "AR1372002938164207618", "parentId": "", "remark": "一级区域-02", "updateTime": 1615945966000, "updateUser": "zhangsan" } ], "respCode": "00000", "respMsg": "success" } ### 查询区域权限树(权限过滤) URL:http://develop.persagy.com/integrated-platform/saas-account/area/queryAllowAreaTree Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"zhangsan", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST" //集团编码,选填 } 返回: { "content": [ { "areaCode": "1001", //区域编码 "areaName": "一级区域-01", //区域名称 "areaType": "0", //区域类别,0-非最底层区域,1-最底层区域 "childrens": [], //下级区域集合 "createTime": 1615945924000, "groupCode": "TEST", "id": "AR1372002764192866305", //区域ID "parentId": "", //上级区域ID "remark": "一级区域-01", //备注 "updateTime": 1615945924000, "updateUser": "zhangsan" }, { "areaCode": "1002", "areaName": "一级区域-02", "areaType": "0", "childrens": [ { "areaCode": "100202", "areaName": "二级区域-02", "areaType": "0", "childrens": [], "createTime": 1615945988000, "groupCode": "TEST", "id": "AR1372003033744007169", "parentId": "AR1372002938164207618", "remark": "二级区域-02", "updateTime": 1615945988000, "updateUser": "zhangsan" }, { "areaCode": "100201", "areaName": "二级区域-01", "areaType": "0", "childrens": [ { "areaCode": "10020101", "areaName": "三级区域-01", "areaType": "1", "childrens": [], "createTime": 1615946017000, "groupCode": "TEST", "id": "AR1372003152283426817", "parentId": "AR1372003069462700033", "remark": "三级区域-01", "updateTime": 1615946017000, "updateUser": "zhangsan" } ], "createTime": 1615945997000, "groupCode": "TEST", "id": "AR1372003069462700033", "parentId": "AR1372002938164207618", "remark": "二级区域-01", "updateTime": 1615945997000, "updateUser": "zhangsan" } ], "createTime": 1615945966000, "groupCode": "TEST", "id": "AR1372002938164207618", "parentId": "", "remark": "一级区域-02", "updateTime": 1615945966000, "updateUser": "zhangsan" } ], "respCode": "00000", "respMsg": "success" } ### 区域平铺列表查询 说明:当 isTotal 为true时,根据账号ID,做项目可见性的判断,否则为全局,不作任何数据过滤 URL:http://develop.persagy.com/integrated-platform/saas-account/area/querySaasAreaList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,必填 "accountId":"AC123456789", //当前账号ID,当 isTotal 为true时,作为sql条件,否则,不做为sql条件,必填 "groupCode":"TEST", //集团编码,必填 "id":"AR1372003203151945730", //区域ID,选填 "parentId":"100201", //上级区域ID,选填 "areaCode":"10020102", //区域编码,选填 "areaName":"三级区域-02", //区域名称,支持模糊查询,选填 "areaType":"1", //区域类别,0-非最底层区域,1-最底层区域,选填 "isTotal":true //是否统计出该层区域及其下级所包含区域对应的所有项目数量,默认false-不统计 } 返回: { "content": [ { "areaCode": "10020102", "areaName": "三级区域-02", "areaType": "1", "createTime": 1615946029000, "groupCode": "TEST", "id": "AR1372003203151945730", "parentId": "100201", "projectNum": 0, // 该层区域下所包含的所有的项目ID,当isTotal条件为false时,该字段不存在 "remark": "三级区域-02", "updateTime": 1615946029000, "updateUser": "zhangsan" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 底层区域平铺列表查询(权限过滤) URL:http://develop.persagy.com/integrated-platform/saas-account/area/queryAllowSaasAreaList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,必填 "accountId":"AC123456789", //当前账号ID,必填,做为sql条件 "groupCode":"TEST", //集团编码,必填 "id":"AR1372003203151945730", //区域ID,选填 "parentId":"100201", //上级区域ID,选填 "areaCode":"10020102", //区域编码,选填 "areaName":"三级区域-02", //区域名称,支持模糊查询,选填 "areaType":"1", //区域类别,0-非最底层区域,1-最底层区域,选填 "isTotal":true //是否统计出该层区域下,所有项目的数量,默认false-不统计 } 返回: { "content": [ { "areaCode": "10020102", "areaName": "三级区域-02", "areaType": "1", "createTime": 1615946029000, "groupCode": "TEST", "id": "AR1372003203151945730", "parentId": "100201", "projectNum": 0, // 该层区域下所包含的所有的项目ID,当isTotal条件为false时,该字段不存在 "remark": "三级区域-02", "updateTime": 1615946029000, "updateUser": "zhangsan" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 创建区域信息 URL:http://develop.persagy.com/integrated-platform/saas-account/area/createSaasArea Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,必填,不做为sql条件 "accountId":"AC1372001812832444418", //当前账号ID,必填,作为sql条件 "groupCode":"TEST", //集团编码,必填 "parentId":"", //上级区域ID,选填 "areaCode":"1001", //区域编码,选填 "areaName":"一级区域", //区域名称,必填 "areaType":"0", //区域类别,0-非最底层区域,1-最底层区域,必填 "remark":"一级区域" //备注,选填 } 返回: { "content": "AR1372001812832444418", "respCode": "00000", "respMsg": "保存成功" } ### 更新区域信息 URL:http://develop.persagy.com/integrated-platform/saas-account/area/updateSaasArea Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,必填,不做为sql条件 "accountId":"AC1372001812832444418", //当前账号ID,必填,不做为sql条件 "id":"AR1372001812832444418", //区域ID,必填 "groupCode":"TEST", //集团编码,必填 "parentId":"", //上级区域ID,选填 "areaCode":"1001", //区域编码,选填 "areaName":"一级区域", //区域名称,必填 "areaType":"0", //区域类别,0-非最底层区域,1-最底层区域,必填 "remark":"一级区域" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 删除区域信息 URL:http://develop.persagy.com/integrated-platform/saas-account/area/deleteSaasArea Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,必填,不做为sql条件 "accountId":"AC1372001812832444418", //当前账号ID,必填,做为sql条件 "groupCode":"TEST", //集团编码,必填 "id":"AR1372001812832444418" //区域ID,必填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 项目管理 ### 查询项目信息 URL:http://develop.persagy.com/integrated-platform/saas-account/project/querySaasProjectList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"1371367185138696194", //主键ID,选填 "accountId":"1371370289309515777", //当前账号ID,必填,作为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,选填 "projectId":"Pj1209010205", //项目ID,选填 "projectIds":[ //项目ID集合,选填 "Pj1209010205" ], "areaId":"123", //区域ID,选填 "projectLocalId":"1209010205", //项目本地编码,选填 "projectName":"测试项目" //项目名称,支持模糊查询,选填 } 返回: { "content": [ { "areaId": "123", "areaName": "测试区域", "createTime": 1615794390000, "groupCode": "TEST", "id": "1371367185138696194", "projectId": "Pj1209010205", "projectLocalId": "1209010205", "projectName": "测试项目", "remark": "项目备注信息", "updateTime": 1615794390000, "updateUser": "1371370289309515777", "valid": 1 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 集团-区域项目平铺列表查询 说明:接口返回数据会包括,被分配的最后一级区域信息,以及被分配的项目信息,均平铺返回 URL:http://develop.persagy.com/integrated-platform/saas-account/project/queryGroupProjectList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,选填,不做为sql条件 "groupCode":"TEST", //集团编码,选填 "accountId":"1371370289309515777", //当前账号ID,必填,作为sql条件 "appId":"PC" //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,选填,不做为sql条件 } 返回: { "content": {[ { "areaId": "123", "areaName": "测试区域", "createTime": 1615794390000, "groupCode": "TEST", "id": "1371367185138696194", "projectId": "Pj1209010205", "projectLocalId": "1209010205", "projectName": "测试项目", "remark": "项目备注信息", "updateTime": 1615794390000, "updateUser": "1371370289309515777", "valid": 1 } ], "respCode": "00000", "respMsg": "success" } ### 查询集团区域项目树(全局) 结构:集团->区域->项目,此接口未根据账号ID做数据可见性的范围限制,返回信息为全局信息 URL:http://develop.persagy.com/integrated-platform/saas-account/project/queryAreaProjectTree Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"1371367185138696194", //主键ID,选填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,选填 "projectId":"Pj1209010205", //项目ID,选填 "areaId":"123", //区域ID,选填 "projectLocalId":"1209010205", //项目本地编码,选填 "projectName":"测试项目" //项目名称,支持模糊查询,选填 } 返回: { "content": [ { "areas": [ //集团下区域集合 { "areaCode": "1001", //区域编码 "areaName": "一级区域-01", //区域名称 "areaType": "0", //区域类别,0-非最底层区域,1-最底层区域 "childrens": [], //下级区域集合 "createTime": 1615945924000, "groupCode": "TEST", "id": "AR1372002764192866305", //区域ID "parentId": "", //上级区域ID "remark": "一级区域-01", "updateTime": 1615945924000, "updateUser": "zhangsan" }, { "areaCode": "1002", "areaName": "一级区域-02", "areaType": "0", "childrens": [ { "areaCode": "100202", "areaName": "二级区域-02", "areaType": "0", "childrens": [], "createTime": 1615945988000, "groupCode": "TEST", "id": "AR1372003033744007169", "parentId": "AR1372002938164207618", "remark": "二级区域-02", "updateTime": 1615945988000, "updateUser": "zhangsan" }, { "areaCode": "100201", "areaName": "二级区域-01", "areaType": "0", "childrens": [ { "areaCode": "10020101", "areaName": "三级区域-01", "areaType": "1", "childrens": [], "createTime": 1615946017000, "groupCode": "TEST", "id": "AR1372003152283426817", "parentId": "AR1372003069462700033", "projects": [ // 区域下项目集合信息 { "areaId": "AR1372003152283426817", "createTime": 1615794390000, "groupCode": "TEST", "id": "1371367185138696194", "projectId": "Pj1209010205", "projectLocalId": "1209010205", "projectName": "测试项目", "remark": "项目备注信息", "updateTime": 1615794697000, "updateUser": "zhangsan", "valid": 1 } ], "remark": "三级区域-01", "updateTime": 1615946017000, "updateUser": "zhangsan" }, { "areaCode": "10020102", "areaName": "三级区域-02", "areaType": "1", "childrens": [], "createTime": 1615946029000, "groupCode": "TEST", "id": "AR1372003203151945730", "parentId": "AR1372003069462700033", "projects": [], "remark": "三级区域-02", "updateTime": 1615946029000, "updateUser": "zhangsan" } ], "createTime": 1615945997000, "groupCode": "TEST", "id": "AR1372003069462700033", "parentId": "AR1372002938164207618", "remark": "二级区域-01", "updateTime": 1615945997000, "updateUser": "zhangsan" } ], "createTime": 1615945966000, "groupCode": "TEST", "id": "AR1372002938164207618", "parentId": "", "remark": "一级区域-02", "updateTime": 1615945966000, "updateUser": "zhangsan" } ], "createTime": 1615793880000, "deployModel": "0", //集团部署方式,0-公有云,1-私有云 "groupCode": "TEST", //集团编码 "groupDesc": "测试集团", //集团描述 "groupIcon": "http://127.0.0.1:9999/test.img", "groupName": "测试集团", //集团名称 "remark": "集团备注信息", "syncState": "2", //数据同步状态,0-数据同步失败,1-数据同步成功,2-未同步 "updateTime": 1615794207000, "updateUser": "zhangsan", "valid": 1 } ], "respCode": "00000", "respMsg": "success" } ### 查询集团区域项目树(权限过滤) 结构:集团->区域->项目,根据账号ID,做数据权限过滤 ``` URL:http://develop.persagy.com/integrated-platform/saas-account/project/queryAllowAreaProjectTree Method:POST Header:Content-Type=application/json ``` 请求: ``` { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1375000220760301569", //当前账号ID,必填,作为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"PUTONG", //集团编码,选填 "id":"PR1375797952055988226", //主键ID,选填 "projectId":"Pj1209010205", //项目ID,选填 "projectIds":[ //项目ID集合,选填 "Pj1209010205" ], "areaId":"AR1375797850927124484", //区域ID,选填 "projectLocalId":"1209010205", //项目本地编码,选填 "projectName":"项目", //项目名称,支持模糊查询,选填 "showEmptyArea":false // 是否展示空的区域信息,即不存在项目的空区域,默认true-展示 } ``` 返回: ``` { "content": [ { "areas": [ { "areaCode": "", "areaName": "分区1", "areaType": "0", //0-非底层区域,1-底层区域 "childrens": [ //下级分区信息集合 { "areaCode": "", "areaName": "分区1-下级", "areaType": "1", "childrens": [], "createTime": 1616850743000, "groupCode": "PUTONG", "id": "AR1375797850927124484", "parentId": "AR1375797850927124482", "projects": [ //该区域对应的项目集合信息 { "areaId": "AR1375797850927124484", "areaName": "分区1-下级", "createTime": 1616774400000, "groupCode": "PUTONG", "id": "PR1375797952055988226", "projectId": "Pj1209010205", "projectLocalId": "1209010205", "projectName": "项目一", "updateTime": 1616774400000, "updateUser": "AC1375000220760301569", "valid": 1 } ], "updateTime": 1616850743000, "updateUser": "AC1375000220760301569" } ], "createTime": 1616850743000, "groupCode": "PUTONG", "id": "AR1375797850927124482", "updateTime": 1616850743000, "updateUser": "AC1375000220760301569" } ], "createTime": 1616908347000, "groupCode": "PUTONG", "groupName": "其他权限集团", "syncState": "2", "updateTime": 1616908347000, "updateUser": "AC1372371635352403969", "valid": 1 } ] "respCode": "00000", "respMsg": "success" } ``` ### 分页查询项目信息 URL:http://develop.persagy.com/integrated-platform/saas-account/project/queryProjectPageList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"1371367185138696194", //主键ID,选填 "accountId":"1371370289309515777", //当前账号ID,必填,作为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,选填 "projectId":"Pj1209010205", //项目ID,选填 "areaId":"123", //区域ID,选填 "projectLocalId":"1209010205", //项目本地编码,选填 "projectName":"测试项目", //项目名称,支持模糊查询,选填 "page":1, //分页页码,不可低于1,必填 "size":10 //分页大小,不可低于1,必填 } 返回: { "content": [ { "areaId": "123", "areaName": "测试区域", "createTime": 1615794390000, "groupCode": "TEST", "id": "1371367185138696194", "projectId": "Pj1209010205", "projectLocalId": "1209010205", "projectName": "测试项目", "remark": "项目备注信息", "provinceCode":"", "cityCode":"", "zoneCode":"", "projectFun":"", "projectWeather":"", "projectImage":["test.jpg"], "longitude":"", "latitude":"", "location":"", "openTime":14654645212, //开业时间 "updateTime": 1615794390000, "updateUser": "1371370289309515777", "valid": 1 } ], "count": 1, //总记录数大小 "respCode": "00000", "respMsg": "success" } ### 创建项目信息 URL:http://develop.persagy.com/integrated-platform/saas-account/project/createSaasProject Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,必填 "projectId":"Pj1209010205", //项目ID,必填 "areaId":"123", //区域ID,选填 "projectLocalId":"1209010205", //项目本地编码,必填 "projectName":"测试项目", //项目名称,必填 "provinceCode":"", //省份编码,选填 "cityCode":"", //城市编码,选填 "zoneCode":"", //区域编码,选填 "projectFun":"", //项目功能类型,选填 "projectWeather":"", //项目天气,选填 "longitude":"", //项目经度,选填 "latitude":"", //项目纬度,选填 "projectImage":[], //项目图片,选填 "location":"", //项目详细地址,选填 "openTime":14654645212, //项目开业时间,选填 "remark":"项目备注信息" //备注,选填 } 返回: { "content": "PR1371761303924879361", "respCode": "00000", "respMsg": "保存成功" } ### 更新项目信息 URL:http://develop.persagy.com/integrated-platform/saas-account/project/updateSaasProject Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"1371367185138696194", //主键ID,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,必填 "projectId":"Pj1209010205", //项目ID,必填 "areaId":"123", //区域ID,选填 "projectLocalId":"1209010205", //项目本地编码,必填 "projectName":"测试项目", //项目名称,必填 "provinceCode":"", //省份编码,选填 "cityCode":"", //城市编码,选填 "zoneCode":"", //区域编码,选填 "projectFun":"", //项目功能类型,选填 "projectWeather":"", //项目天气,选填 "longitude":"", //项目经度,选填 "latitude":"", //项目纬度,选填 "projectImage":[], //项目图片,选填 "location":"", //项目详细地址,选填 "openTime":14654645212, //项目开业时间,选填 "remark":"项目备注信息" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 批量变更项目所属区域 URL:http://develop.persagy.com/integrated-platform/saas-account/project/batchUpdateProjectArea Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST", //集团编码,必填 "areaId":"AR1372447231903342594", //区域ID,必填 "projectIds": [ //项目ID集合,必填 "Pj1209010207" ] } 返回: { "respCode": "00000", "respMsg": "更新成功" } ## 账号管理 ### 查询账号信息 URL:http://develop.persagy.com/integrated-platform/saas-account/account/querySaasAccountList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,选填 "groupCode":"TEST", //集团编码,选填 "accountId":"1371370289309515777", //当前账号ID,选填,会作为sql条件 "accountIds":["1371370289309515777"], //当前账号ID集合,选填,会作为sql条件 "accountType":"0", //账号类型, 0-超级管理员(所有集团),1-单集团管理员(单集团),2-普通账号,选填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,选填 "username":"zhangsan", //登录用户名,支持模糊查询,选填 "phoneNum":"18888888888", //手机号,选填 "accountSource":"persagy" //账号来源,选填 } 返回: { "content": [ { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号 "accountSource": "persagy", "accountType": "0", "terminal": [ "PC" ], "createTime": 1615795130000, "validEndTime": 1899791706000, "groupCode": "TEST", "headPortrait": "http://127.0.0.1:8080/test.img", "id": "1371370289309515777", "mail": "18888888888@163.com", "password": "123456", "phoneNum": "18888888888", "remark": "remark", "updateTime": 1615795130000, "username": "zhangsan", "valid": 1, "validStartTime": 1615720476000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 查询角色账号信息 URL:http://develop.persagy.com/integrated-platform/saas-account/account/queryRoleAccountList Method:POST Header:Content-Type=application/json 请求: { "groupCode":"WD", //集团编码,必填 "roleId":"RO1372505156457959327", //角色ID,必填 "valid":1 //是否可用,0-不可用,1-可用,选填 } 返回: { "content": [ { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号 "accountSource": "persagy", "accountType": "0", "terminal": [ "PC" ], "createTime": 1615795130000, "validEndTime": 1899791706000, "groupCode": "TEST", "headPortrait": "http://127.0.0.1:8080/test.img", "id": "1371370289309515777", "mail": "18888888888@163.com", "password": "123456", "phoneNum": "18888888888", "remark": "remark", "updateTime": 1615795130000, "username": "zhangsan", "valid": 1, "validStartTime": 1615720476000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 分页查询角色账号信息 URL:http://develop.persagy.com/integrated-platform/saas-account/account/queryRoleAccountPage Method:POST Header:Content-Type=application/json 请求: { "groupCode":"WD", //集团编码,必填 "roleIds":["RO1372505156457959327"], //角色ID,必填 "casType":"0", //关联类型,0-主岗,1-副岗,2-业务超管默认角色 "valid":1, //是否可用,0-不可用,1-可用,选填 "page":1, //分页页码,不可低于1,必填 "size":10 //分页大小,不可低于1,必填 } 返回: { "content": [ { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号 "accountSource": "persagy", "accountType": "0", "terminal": [ "PC" ], "createTime": 1615795130000, "validEndTime": 1899791706000, "groupCode": "TEST", "headPortrait": "http://127.0.0.1:8080/test.img", "id": "1371370289309515777", "mail": "18888888888@163.com", "password": "123456", "phoneNum": "18888888888", "remark": "remark", "updateTime": 1615795130000, "username": "zhangsan", "valid": 1, "validStartTime": 1615720476000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 分页查询账号信息 URL:http://develop.persagy.com/integrated-platform/saas-account/account/queryAccountPageList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,选填 "groupCode":"sybs", //集团编码,选填 "accountId":"AC1377819021444931585", //当前账号ID,选填,会作为sql条件 "accountIds":["AC1377819021444931585"], //当前账号ID集合,选填,会作为sql条件 "accountType":"0", //账号类型, 0-超级管理员(所有集团),1-单集团管理员(单集团),2-普通账号,选填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,选填 "username":"sybs", //登录用户名,支持模糊查询,选填 "phoneNum":"18888888888", //手机号,选填 "accountSource":"persagy", //账号来源,选填 "showRoles":true, // 是否显示roles,true-显示,默认false "showGroup":true, //是否显示集团信息,true-显示,默认false "page":1, //分页页码,不可低于1,必填 "size":10 //分页大小,不可低于1,必填 } 返回: { "content": [ { "accountBelong": "1", "accountSource": "persagy", "accountType": "1", "terminal": [ "PC" ], "createTime": 1617292800000, "groupCode": "sybs", "groupName": "啥也不是", "id": "AC1377819021444931585", "lastLoginIp": "127.0.0.1", "lastLoginTime": 1617292800000, "roles": [ { "groupCode": "sybs", "id": "RO1377815673866051586", "remark": "自动创建默认业务超管角色", "roleCode": "1001", "roleName": "业务超管默认角色", "roleType": "2" } ], "updateTime": 1617292800000, "updateUser": "AC1372371635352403969", "username": "sybs", "valid": 1, //是否可用,0-不可用,1-可用 "validEndTime": 1924876800000, "validLast": "0", // 账号有效期,0-期内有效,1-永久有效 "validStartTime": 1609344000000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 根据账号名称查询账号信息 URL:http://develop.persagy.com/integrated-platform/saas-account/account/querySaasAccountByUsername Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "groupCode":"TEST", //集团编码,必填 "username":"zhangsan", //登录用户名,必填 } 返回: { "content": [ { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号 "accountSource": "persagy", "accountType": "0", "terminal": [ "PC" ], "createTime": 1615795130000, "validEndTime": 1899791706000, "groupCode": "TEST", "headPortrait": "http://127.0.0.1:8080/test.img", "id": "1371370289309515777", "mail": "18888888888@163.com", "password": "123456", "phoneNum": "18888888888", "remark": "remark", "updateTime": 1615795130000, "username": "zhangsan", "valid": 1, "validStartTime": 1615720476000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 创建账号信息 URL:http://develop.persagy.com/integrated-platform/saas-account/account/createSaasAccount Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "groupCode":"TEST", //集团编码,选填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "username":"zhangsan", //登录用户名,必填 "password":"123456", //登录密码,不填,默认123456 "phoneNum":"18888888888", //手机号,选填 "mail":"18888888888@163.com", //邮箱,选填 "headPortrait":"http://127.0.0.1:8080/test.img", //头像,图片URL,选填 "accountType":"0", //账号类型, 0-超级管理员(所有集团),1-单集团管理员(单集团),2-普通账号,必填 "accountSource":"persagy", //账号来源,必填 "validStartTime":1615720476050, // 账号有效期的开始时间,时间戳格式,选填 "validEndTime":1899791706000, // 账号有效期的结束时间,时间戳格式,选填 "validLast":"0", //账号有效期,0-期内有效,1-永久有效,当为0时,validStartTime 和 validEndTime 必填 "remark":"remark", //备注,选填 "valid":"1", // 是否可用,0-不可用,1-可用,选填,默认为1 "casType":"0" //关联类型,0-主岗,1-副岗,2-业务超管默认角色,这里的关联类型,会作为重置的条件,进行删除数据的依据,选填 "roles":[ // 账号关联的角色,会先删除此账号对应的角色信息,再添加,选填 { "roleId":"RO0134568781001" //角色ID } ] } 返回: { "content": "AC1371761303924879361", "respCode": "00000", "respMsg": "保存成功" } ### 更新账号信息 URL:http://develop.persagy.com/integrated-platform/saas-account/account/updateSaasAccount Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //账号ID,必填 "groupCode":"TEST", //集团编码,选填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "username":"zhangsan", //登录用户名,必填 "password":"123456", //登录密码,不填,默认123456 "phoneNum":"18888888888", //手机号,选填 "mail":"18888888888@163.com", //邮箱,选填 "headPortrait":"http://127.0.0.1:8080/test.img", //头像,图片URL,选填 "accountType":"0", //账号类型, 0-超级管理员(所有集团),1-单集团管理员(单集团),2-普通账号,必填 "accountSource":"persagy", //账号来源,必填 "validStartTime":1615720476050, // 账号有效期的开始时间,时间戳格式,选填 "validEndTime":1899791706000, // 账号有效期的结束时间,时间戳格式,选填 "validLast":"0", //账号有效期,0-期内有效,1-永久有效;当为0时,validStartTime 和 validEndTime 必填 "remark":"账号备注信息", //备注,选填 "valid":"1", // 是否可用,0-不可用,1-可用,必填 "casType":"0" //关联类型,0-主岗,1-副岗,2-业务超管默认角色,这里的关联类型,会作为重置的条件,进行删除数据的依据,选填 "roles":[ // 账号关联的角色,会先删除此账号对应的角色信息,再添加,选填 { "roleId":"RO0134568781001" //角色ID } ] } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 集团关联业务超管账号 URL:http://develop.persagy.com/integrated-platform/saas-account/account/addSaasAccountGroup Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1371370289309515777", //账号ID,必填,注意这里是关联着的账号ID,而非登录着的账号ID "groupCode":"TEST", //集团编码,必填 "appId":"PC" //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,必填,目前不作为sql条件 } 返回: { "respCode": "00000", "respMsg": "关联成功" } ### 禁用账号 URL:http://develop.persagy.com/integrated-platform/saas-account/account/deleteSaasAccount Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //账号ID,必填 "groupCode":"TEST", //集团编码,必填 "appId":"PC" //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,目前不作为sql条件 } 返回: { "respCode": "00000", "respMsg": "禁用成功" } ### 启用账号 URL:http://develop.persagy.com/integrated-platform/saas-account/account/enableSaasAccount Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //账号ID,必填 "groupCode":"TEST", //集团编码,必填 "appId":"PC" //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,目前不作为sql条件 } 返回: { "respCode": "00000", "respMsg": "启用成功" } ### 修改密码 URL:http://develop.persagy.com/integrated-platform/saas-account/account/updateAccountPwd Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //账号ID,必填,作为sql条件 "groupCode":"TEST", //集团编码,选填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,目前不作为sql条件 "oldPassword":"123456", //账号旧密码,不可为空 "newPassword":"123456" //账号新密码,不可为空 } 返回: { "respCode": "00000", "respMsg": "密码修改成功" } ### 重置密码 URL:http://develop.persagy.com/integrated-platform/saas-account/account/resetAccountPwd Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //账号ID,必填,作为sql条件 "groupCode":"TEST", //集团编码,选填 "appId":"PC" //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,目前不作为sql条件 } 返回: { "respCode": "00000", "respMsg": "密码重置成功" } ## 产品管理 ### 产品类别树查询 URL:http://develop.persagy.com/integrated-platform/saas-account/productCategory/querySaasProductCategoryTree Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC" // 应用ID,PC-电脑,APP-手机应用,必填,不做为sql条件 } 返回: { "content": [ { "categoryIcon": "department", "categoryName": "客户系统", "childrens": [ { "categoryName": "智慧建筑运维平台", "childrens": [], "createTime": 1620763620000, "id": "PC1392085326922633217", "menuType": "1", "parentId": "PC1392084360873758722", "productType": "1", "remark": "APM+FMS", "terminal": "PC", "terminalName": "WEB" }, { "categoryName": "智慧建筑运维平台", "childrens": [], "createTime": 1620763629000, "id": "PC1392085498129928194", "menuType": "1", "parentId": "PC1392084360873758722", "productType": "1", "remark": "APM+FMS", "terminal": "APP", "terminalName": "APP" }, { "categoryName": "报警中心", "childrens": [], "createTime": 1620763637000, "id": "PC1392085641155694594", "menuType": "2", "parentId": "PC1392084360873758722", "productType": "2", "remark": "IBMS", "terminal": "APP", "terminalName": "APP" }, { "categoryName": "报警中心", "childrens": [], "createTime": 1620763645000, "id": "PC1392085678459834370", "menuType": "2", "parentId": "PC1392084360873758722", "productType": "2", "remark": "IBMS", "terminal": "PC", "terminalName": "WEB" } ], "createTime": 1620763599000, "id": "PC1392084360873758722", "remark": "客户系统" }, { "categoryIcon": "mobileTerminal", "categoryName": "内部系统", "childrens": [ { "categoryName": "运维平台", "childrens": [], "createTime": 1620763661000, "id": "PC1392086234628739073", "menuType": "0", "parentId": "PC1392086070706950145", "productType": "0", "remark": "BMP", "terminal": "PC", "terminalName": "WEB" }, { "categoryName": "数字化交付", "childrens": [], "createTime": 1620763669000, "id": "PC1392086414723764225", "menuType": "3", "parentId": "PC1392086070706950145", "productType": "3", "remark": "ADM", "terminal": "PC", "terminalName": "WEB" } ], "createTime": 1620763654000, "id": "PC1392086070706950145", "remark": "内部系统" } ], "respCode": "00000", "respMsg": "success" } ### 集团签约产品信息查询 URL:http://develop.persagy.com/integrated-platform/saas-account/groupProduct/querySaasGroupProductList Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"TEST", //集团编码,必填 "productId":"PD1390234244466438145", // 产品ID,选填 "validLast":"1" // 签约有效期,0-期内有效,1-永久有效,选填 } 返回: { "content": [ { "groupCode": "TEST", "id": "GP1391603821226078210", "productContract": 1620619180000, "productId": "PD1390234244466438145", "productRange": "0", "remark": "测试", "updateTime": 1620619180000, "updateUser": "AC1372371635352403969", "validEndTime": 1620616920000, "validLast": "1", "validStartTime": 1620616909000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 集团签约产品分页信息查询 URL:http://develop.persagy.com/integrated-platform/saas-account/groupProduct/queryGroupProductPageList Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"TEST", //集团编码,必填 "productId":"PD1390234244466438145", // 产品ID,选填 "validLast":"1", // 签约有效期,0-期内有效,1-永久有效,选填 "totalProject":false, //是否统计项目数,true-统计,默认false "page":1, //分页页码,不可低于1,必填 "size":10 //分页大小,不可低于1,必填 } 返回: { "content": [ { "groupCode": "TEST", "id": "GP1391603821226078210", "productContract": 1620619180000, "productId": "PD1390234244466438145", "productRange": "0", "remark": "测试", "updateTime": 1620619180000, "updateUser": "AC1372371635352403969", "validEndTime": 1620616920000, "validLast": "1", "validStartTime": 1620616909000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 集团签约产品 URL:http://develop.persagy.com/integrated-platform/saas-account/groupProduct/createSaasGroupProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,此处的APP ID 来源于产品信息中的,目前无用 "groupCode":"TEST", //集团编码,必填 "productId":"PD1390234244466438145", // 产品ID,必填 "productRange":"0", //产品使用范围,0-全部项目,1-部分项目,必填 "pageIds":[ // 页面ID集合,必填 "PA1390240032173895682" ], "validStartTime":1620616909201, // 签约有效期为0时,必填 "validEndTime":1620616920187, // 签约有效期为0时,必填 "validLast":"1", // 签约有效期,0-期内有效,1-永久有效,必填 "remark":"测试" //备注,选填 } 返回: { "content": "GP1391598206613241857", "respCode": "00000", "respMsg": "保存成功" } ### 更新集团签约产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/groupProduct/updateSaasGroupProduct Method:POST Header:Content-Type=application/json 请求: { "id":"GP1391598206613241857", //签约ID,必填 "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,此处的APP ID 来源于产品信息中的,目前无用 "groupCode":"TEST", //集团编码,必填 "productId":"PD1390234244466438145", // 产品ID,必填 "productRange":"0", //产品使用范围,0-全部项目,1-部分项目,必填 "pageIds":[ // 页面ID集合,必填 "PA1390240032173895682" ], "validStartTime":1620616909201, // 签约有效期为0时,必填 "validEndTime":1620616920187, // 签约有效期为0时,必填 "validLast":"1", // 签约有效期,0-期内有效,1-永久有效,必填 "remark":"测试" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 删除集团签约产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/groupProduct/deleteSaasGroupProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"TEST", //集团编码,必填 "productId":"PD1390234244466438145" // 产品ID,必填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ### 项目签约产品信息查询 URL:http://develop.persagy.com/integrated-platform/saas-account/projectProduct/querySaasProjectProductList Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"QKZZ", //集团编码,必填 "contractId":"GP1391603821226078210", //签约ID,选填 "projectId":"Pj1209010205", //项目ID,选填 "productId":"PD1390234244466438145", // 产品ID,选填 "showProjectName":false // 是否展示项目名称,true-展示,默认false } 返回: { "content": [ { "contractId": "GP1391603821226078210", "groupCode": "QKZZ", "productContract": 1620628287000, "productId": "PD1390234244466438145", "projectId": "Pj1209010205", "remark": "测试" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 项目签约产品 URL:http://develop.persagy.com/integrated-platform/saas-account/projectProduct/createSaasProjectProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"QKZZ", //集团编码,必填 "contractId":"GP1391603821226078210", //集团签约ID,必填 "projectId":"Pj1209010205", //项目ID,必填 "productId":"PD1390234244466438145", // 产品ID,必填 "remark":"测试" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "保存成功" } ### 重置项目签约产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/projectProduct/replaceSaasProjectProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"QKZZ", //集团编码,必填 "contractId":"GP1391603821226078210", //集团签约ID,必填 "productId":"PD1390234244466438145", // 产品ID,必填 "projectIds":["Pj1209010206"] //项目ID集合,必填 } 返回: { "respCode": "00000", "respMsg": "重置成功" } ### 更新项目签约产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/projectProduct/updateSaasProjectProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"QKZZ", //集团编码,必填 "contractId":"GP1391603821226078210", //集团签约ID,必填 "projectId":"Pj1209010205", //项目ID,必填 "productId":"PD1390234244466438145", // 产品ID,必填 "remark":"测试" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 删除项目签约产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/projectProduct/deleteSaasProjectProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,目前不做为sql条件,后续要区分端查看时,会作为sql条件 "groupCode":"QKZZ", //集团编码,必填 "contractId":"GP1391603821226078210", //集团签约ID,选填 "projectId":"Pj1209010205", //项目ID,选填 "productId":"PD1390234244466438145" // 产品ID,选填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ### 查询产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/product/querySaasProductList Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC68464684542455", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,不做为sql条件 "productCode":"1001", // 产品编码,选填,唯一 "productName":"测试", // 产品名称,选填,唯一 "productState":"0", // 产品状态,0-建设中,1-已完成,2-已关联,选填 "productMenu":"0", // 产品是否关联菜单,0-未关联,1-已关联,选填 "productType":"0" //产品类型,0-系统产品,1-标准业务产品,2-IBMS产品,选填 } 返回: { "content": [ { "createTime": 1619519546000, "id": "PD1386991620691402753", "productCode": "1001", "productIcon": "layui-test-icon", "productMenu": "0", "productName": "测试", "productState": "0", "remark": "测试但是", "updateTime": 1619519710000, "updateUser": "AC68464684542455" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 分页查询产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/product/queryProductPageList Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC68464684542455", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,不做为sql条件 "productCode":"1001", // 产品编码,选填,唯一 "productName":"测试", // 产品名称,选填,唯一 "productState":"0", // 产品状态,0-建设中,1-已完成,2-已关联,选填 "productMenu":"0", // 产品是否关联菜单,0-未关联,1-已关联,选填 "productType":"0", //产品类型,0-系统产品,1-标准业务产品,2-IBMS产品,选填 "page":1, //分页页码,不可低于1,必填 "size":10 //分页大小,不可低于1,必填 } 返回: { "content": [ { "createTime": 1619519546000, "id": "PD1386991620691402753", "productCode": "1001", "productIcon": "layui-test-icon", "productMenu": "0", "productName": "测试", "productState": "0", "remark": "测试但是", "updateTime": 1619519710000, "updateUser": "AC68464684542455" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 新增产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/product/createSaasProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC68464684542455", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填 "productCode":"1001", // 产品编码,必填,唯一 "productName":"测试", // 产品名称,必填,唯一 "productIcon":"layui-test-icon", // 产品图标,不填,会采用默认的ICON "productState":"0", // 产品状态,0-建设中,1-已完成,2-已关联,必填 "productMenu":"0", // 产品是否关联菜单,0-未关联,1-已关联,必填 "productType":"0", //产品类型,0-系统产品,1-标准业务产品,必填 "remark":"测试" //备注,选填 } 返回: { "content": "PD1386991620691402753", "respCode": "00000", "respMsg": "保存成功" } ### 更新产品信息 URL:http://develop.persagy.com/integrated-platform/saas-account/product/updateSaasProduct Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC68464684542455", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填 "id":"PD1386991620691402753", //产品ID,必填 "productCode":"1001", // 产品编码,必填,唯一 "productName":"测试", // 产品名称,必填,唯一 "productIcon":"layui-test-icon", // 产品图标,必填 "productState":"0", // 产品状态,0-建设中,1-已完成,2-已关联,必填 "productMenu":"0", // 产品是否关联菜单,0-未关联,1-已关联,必填 "productType":"0", //产品类型,0-系统产品,1-标准业务产品,2-IBMS产品,必填 "remark":"测试但是" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 查询产品页面树 URL:http://develop.persagy.com/integrated-platform/saas-account/productPage/querySaasProductPageTree Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填,作为sql条件 "productId":"PD1390234244466438145", //产品ID,选填 "productType":"0", //产品类型,0-系统产品,1-标准业务产品,2-IBMS产品,选填 "showPageAuth": false //是否展示出页面对应的权限信息,true-展示,默认false } 返回: { "content": [ { "appId": "PC", "createTime": 1620292648000, "id": "PD1390234244466438145", "productPages": [ // 该产品下,所有的页面 { "childrens": [], //该产品页面下的子页面 "createTime": 1620292920000, "id": "PA1390235384671203330", "pageAngle": "0", // 页面视角,0-集团项目页,1-集团独有页,2-项目独有页 "pageFloor": "0", // 是否为落地页,0-非落地页,1-集团落地页,2-项目落地页,3-集团项目落地页 "pageIcon": "", "pageName": "测试页面", "pageUrl": "", "parentId": "", "productId": "PD1390234244466438145", "remark": "测试页面", "updateTime": 1620293119000 } ], "productCode": "1002", // 产品编码 "productIcon": "layui-test-icon", "productMenu": "0", // 产品是否关联菜单,0-未关联,1-已关联 "productName": "测试2", "productState": "0", // 产品状态,0-建设中,1-已完成,2-已关联 "remark": "测试", "updateTime": 1620292648000, "updateUser": "AC68464684542455" } ], "respCode": "00000", "respMsg": "success" } ### 新增产品页面信息 URL:http://develop.persagy.com/integrated-platform/saas-account/productPage/createSaasProductPage Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填 "productId":"PD1390234244466438145", //产品ID,必填 "parentId":"", // 上级页面ID,选填 "pageName":"测试页面", // 页面名称,必填 "pageIcon":"", // 页面图标,选填 "pageUrl":"", // 页面URL,选填 "pageAngle":"0", // 页面视角,0-集团项目页,1-集团独有页,2-项目独有页,必填 "pageFloor":"0", // 是否为落地页,0-非落地页,1-集团落地页,2-项目落地页,3-集团项目落地页,默认0,不填-默认0 "pageLevel":1, //当前页面层级,必填 "remark":"测试页面" //备注,选填 } 返回: { "content": "PA1390235384671203330", "respCode": "00000", "respMsg": "保存成功" } ### 更新产品页面信息 URL:http://develop.persagy.com/integrated-platform/saas-account/productPage/updateSaasProductPage Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填 "id":"PA1390235384671203330", //页面ID,必填 "productId":"PD1390234244466438145", //产品ID,必填 "parentId":"", // 上级页面ID,选填 "pageName":"测试页面", // 页面名称,必填 "pageIcon":"", // 页面图标,选填 "pageUrl":"", // 页面URL,选填 "pageAngle":"0", // 页面视角,0-集团项目页,1-集团独有页,2-项目独有页,必填 "pageFloor":"0", // 是否为落地页,0-非落地页,1-集团落地页,2-项目落地页,3-集团项目落地页,默认0,不填-默认0 "pageLevel":1, //当前页面层级,必填 "remark":"测试页面" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 删除产品页面信息 说明:落地页不允许删除,且级联删除此页面的权限点信息 URL:http://develop.persagy.com/integrated-platform/saas-account/productPage/deleteSaasProductPage Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", // 账号ID,必填,不做为sql条件 "appId":"PC", // 应用ID,PC-电脑,APP-手机应用,必填 "id":"PA1390235384671203330" //页面ID,必填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 角色管理 ### 查询角色信息(未做权限过滤,全局角色列表) URL:http://develop.persagy.com/integrated-platform/saas-account/role/querySaasRoleList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "groupCode":"TEST", //集团编码,选填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "id":"RO1371755195843821569", //角色ID, 选填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "roleCode":"1001", //角色编码,选填 "roleType":"0", // 角色类型,0-系统角色,1-业务角色 "roleName":"测试", //角色名称,支持模糊查询,选填 "counMenu":true, //是否统计菜单数量,true-统计,默认false "countFunction":true, //是否统计功能点数量,true-统计,默认false "roleIds":[ //角色ID集合,选填 "RO1371755195843821569" ] } 返回: { "content": [ { "countFunction": 0, // 当参数 countFunction 为 true时存在,代表此角色下所拥有的功能点的数量 "counMenu":0, // 当参数 counMenu 为 true时存在,代表此角色下所拥有的菜单的数量 "createTime": 1615886899000, "groupCode": "TEST", "id": "RO1371755195843821569", "remark": "角色备注信息", "roleCode": "1001", "roleType":"0", "roleName": "测试角色", "updateTime": 1615887053000, "updateUser": "1371370289309515777", "valid": 1 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 分页查询角色信息(未做权限过滤,全局角色列表) URL:http://develop.persagy.com/integrated-platform/saas-account/role/queryRolePageList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"RO1371755195843821569", //角色ID, 选填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "roleCode":"1001", //角色编码,选填 "roleType":"0", // 角色类型,0-系统角色,1-业务角色,选填 "roleTypes":["0"], // 角色类型集合,选填 "roleName":"测试", //角色名称,支持模糊查询,选填 "groupCode":"TEST", //集团编码,必填 "counMenu":true, //是否统计菜单数量,true-统计,默认false "countFunction":true, //是否统计功能点数量,true-统计,默认false "adminOrder":true, // 是否按照超级管理员第一位,其余账号顺延的规则排序 "page":1, //分页页码,不可低于1,必填 "size":10 //分页大小,不可低于1,必填 } 返回: { "content": [ { "countFunction": 0, // 当参数 countFunction 为 true时存在,代表此角色下所拥有的功能点的数量 "counMenu":0, // 当参数 counMenu 为 true时存在,代表此角色下所拥有的菜单的数量 "createTime": 1615886899000, "groupCode": "TEST", "id": "RO1371755195843821569", "remark": "角色备注信息", "roleCode": "1001", "roleType":"0", "roleName": "测试角色", "updateTime": 1615887053000, "updateUser": "1371370289309515777", "valid": 1 } ], "count": 1, //总记录数大小 "respCode": "00000", "respMsg": "success" } ### 根据角色名称查询角色信息 URL:http://develop.persagy.com/integrated-platform/saas-account/role/querySaasRoleByName Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleName":"测试", //角色名称,必填 "roleType":"0", //角色类型,业务使用时必填 } 返回: { "content": [ { "createTime": 1615886899000, "groupCode": "TEST", "id": "RO1371755195843821569", "remark": "角色备注信息", "roleCode": "1001", "roleType":"0", "roleName": "测试角色", "updateTime": 1615887053000, "updateUser": "1371370289309515777", "valid": 1 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ​ ### 创建角色信息 URL:http://develop.persagy.com/integrated-platform/saas-account/role/createSaasRole Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleCode":"1001", //角色编码,必填 "roleType":"0", // 角色类型,0-系统角色,1-业务角色,默认0 "roleName":"测试角色", //角色名称,必填 "remark":"角色备注信息", //备注,选填 "auths": [ //菜单功能集合,选填 { "menuId":"1371376123917754369", //菜单ID,必填 "functionId":"1371376123917754369" //功能ID,选填 }, { "menuId":"1371376123917754369", //菜单ID,必填 "functionId":"1371376123917754380" //功能ID,选填 } ] } 返回: { "content": "RO1371761303924879361", "respCode": "00000", "respMsg": "保存成功" } ### 更新角色信息 URL:http://develop.persagy.com/integrated-platform/saas-account/role/updateSaasRole Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"RO1371755195843821569", //角色ID,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleCode":"1001", //角色编码,必填 "roleType":"0", // 角色类型,0-系统角色,1-业务角色 "roleName":"测试角色", //角色名称,必填 "remark":"角色备注信息", //备注,选填 "auths": [ //菜单功能集合,选填 { "menuId":"1371376123917754369", //菜单ID,必填 "functionId":"1371376123917754369" //功能ID,选填 }, { "menuId":"1371376123917754369", //菜单ID,必填 "functionId":"1371376123917754380" //功能ID,选填 } ] } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 删除角色信息 级联删除账号和角色的关联关系,以及角色和菜单的关联关系 URL:http://develop.persagy.com/integrated-platform/saas-account/role/deleteSaasRole Method:POST Header:Content-Type=application/json 请求: { "id":"RO1372505156457959425", //角色ID,必填 "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST" //集团编码,选填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 菜单管理 ### 查询顶级菜单 URL:http://develop.persagy.com/integrated-platform/saas-account/menu/querySaasMenuTop Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,必填 "menuType":"0" ///菜单类型,0-系统菜单,1-业务菜单,必填 } 返回: { "content": [ { "appId": "PC", "createTime": 1618242292000, "id": "ME1372501618212643050", "menuCode": "1002", "menuName": "账号权限管理", "menuSort": 2, "menuType": "0", "menuIcon":"", "menuUrl": "/oms/accountPermission", "remark": "账号权限管理", "updateTime": 1618242292000, "updateUser": "AC1372371635352403969", "urlType": "0" } ], "respCode": "00000", "respMsg": "success" } ### 查询菜单功能树(不做权限过滤) URL:http://develop.persagy.com/integrated-platform/saas-account/menu/queryMenuFunTree Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,做为sql条件 "menuId":"ME1372505574210637825", //菜单ID,选填 "menuType":"0", //菜单类型,0-系统菜单,1-标准业务菜单,2-IBMS菜单,必填 "isMenu":false //是否仅查询出菜单树,true-是,默认false } 返回: { "content": [ { "appId": "PC", "childrens": [], "createTime": 1617335946000, "functions": [ { "createTime": 1617335946000, "funCode": "1001", "funName": "新增集团信息", "funSort": 1, "funUrl": "/group/createSaasGroup", "id": "FU1372509049900339201", "menuId": "ME1372505574210637825", "remark": "新增集团信息", "updateTime": 1617335946000, "updateUser": "AC1372371635352403969" }, { "createTime": 1617335946000, "funCode": "1005", "funName": "新增项目信息", "funSort": 4, "funUrl": "/project/createSaasProject", "id": "FU1372509049900339202", "menuId": "ME1372505574210637825", "remark": "新增项目信息", "updateTime": 1617335946000, "updateUser": "AC1372371635352403969" }, { "createTime": 1617335946000, "funCode": "1003", "funName": "修改集团信息", "funSort": 2, "funUrl": "/group/updateSaasGroup", "id": "FU1372509217085296641", "menuId": "ME1372505574210637825", "remark": "修改集团信息", "updateTime": 1617335946000, "updateUser": "AC1372371635352403969" }, { "createTime": 1617335946000, "funCode": "1007", "funName": "修改项目信息", "funSort": 5, "funUrl": "/project/updateSaasProject", "id": "FU1372509217085296642", "menuId": "ME1372505574210637825", "remark": "修改项目信息", "updateTime": 1617335946000, "updateUser": "AC1372371635352403969" }, { "createTime": 1617335946000, "funCode": "1004", "funName": "查询集团列表信息", "funSort": 3, "funUrl": "/project/querySaasGroupList", "id": "FU1372509383896961026", "menuId": "ME1372505574210637825", "remark": "查询集团列表信息", "updateTime": 1617335946000, "updateUser": "AC1372371635352403969" } ], "id": "ME1372505574210637825", "menuCode": "1001", "menuId": "ME1372505574210637825", "menuName": "集团项目管理", "menuSort": 1, "menuType": "0", "menuUrl": "/oms/groupAndProjectManagement/", "parentId": "", "remark": "集团项目管理", "updateTime": 1617335946000, "updateUser": "AC1372371635352403969", "urlType": "0" } ], "respCode": "00000", "respMsg": "success" } ### 查询账号菜单功能权限树(权限过滤) URL:http://develop.persagy.com/integrated-platform/saas-account/menu/querySaasMenuTree Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"1", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,必填 "productId":"PD1390234244466438145", //产品ID,选填 "projectId":"Pj1209010205", //项目ID,存在即为项目视角 "groupCode":"tes", //集团编码,选填 "isMenu":false //是否仅查询出菜单树,true-是,默认false } 返回: { "content": [ { "accountId": "1371370289309515777", "appId": "PC", "childrens": [ //下级菜单 { "accountId": "1371370289309515777", "appId": "PC", "childrens": [ { "accountId": "1371370289309515777", "appId": "PC", "childrens": [], "functions": [ // 此菜单所对应的功能点集合 { "funCode": "1001010101", //功能编码 "funName": "查询", "funSort": 1, // 功能顺序 "funUrl": "/account/querySaasAccountList", //功能URL "groupCode": "TEST", "id": "FU1371634297690148866", //功能ID "menuId": "1371376123917754369", //菜单ID "remark": "功能点备注信息" }, { "funCode": "1001010102", "funName": "删除", "funSort": 2, "funUrl": "/account/deleteSaasAccount", "groupCode": "TEST", "id": "FU1371635736550330370", "menuId": "1371376123917754369", "remark": "功能点备注信息" } ], "groupCode": "TEST", "menuCode": "10010101", //菜单编码 "menuIcon": "layui-icon", //菜单图标 "menuId": "1371376123917754369", //菜单ID "menuName": "三级-01菜单", //菜单名称 "menuSort": 1, //菜单顺序 "menuUrl": "/account/querySaasAccountList", //菜单URL,根据此值的有无,判断是否为落地页 "urlType":"0", //URL类型,0-相对路径,1-绝对路径 "parentId": "1371375937187340290", //上级菜单ID "remark": "三级-01菜单备注" }, { "accountId": "1371370289309515777", "appId": "PC", "childrens": [], "functions": [], "groupCode": "TEST", "menuCode": "10010102", "menuIcon": "layui-icon", "menuId": "1371376152736817154", "menuName": "三级-02菜单", "menuSort": 2, "menuUrl": "/account/querySaasAccountList", "urlType":"", "parentId": "1371375937187340290", "remark": "三级-02菜单备注" } ], "groupCode": "TEST", "menuCode": "100101", "menuIcon": "layui-icon", "menuId": "1371375937187340290", "menuName": "二级-01菜单", "menuSort": 1, "menuUrl": "", "urlType":"", "parentId": "1371375808132800514", "remark": "二级-01菜单备注" }, { "accountId": "1371370289309515777", "appId": "PC", "childrens": [], "groupCode": "TEST", "menuCode": "100102", "menuIcon": "layui-icon", "menuId": "1371375968732700673", "menuName": "二级-02菜单", "menuSort": 2, "menuUrl": "", "parentId": "1371375808132800514", "remark": "二级-02菜单备注" } ], "groupCode": "TEST", "menuCode": "1001", "menuIcon": "layui-icon", "menuId": "1371375808132800514", "menuName": "一级菜单", "menuSort": 1, "menuUrl": "", "parentId": "", "remark": "一级菜单备注" }, { "accountId": "1371370289309515777", "appId": "PC", "childrens": [], "groupCode": "TEST", "menuCode": "1002", "menuIcon": "layui-icon", "menuId": "ME1371639941642178562", "menuName": "一级-02菜单", "menuSort": 2, "menuUrl": "", "parentId": "", "remark": "一级-02菜单备注" } ], "respCode": "00000", "respMsg": "success" } ### 菜单重排序 URL:http://develop.persagy.com/integrated-platform/saas-account/menu/sortSaasMenu Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID,必填 "menus": [ { "menuId": "ME1372501618212643050", //菜单ID,必填 "parentId":"", // 上级菜单ID,选填,存在会被更新为此值 "menuSort": 2 //菜单顺序,必填 }, { "menuId": "ME1372505574210637826", "menuSort": 1 } ] } 返回: { "respCode": "00000", "respMsg": "调整成功" } ### 创建菜单信息 URL:http://develop.persagy.com/integrated-platform/saas-account/menu/createSaasMenu Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "parentId":"", //上级菜单ID,选填 "productId":"PD1371370289309515257", // 产品ID,选填 "menuCode":"1001", //菜单编码,必填 "menuName":"一级菜单", //菜单名称,必填 "menuUrl":"/query/list", //菜单URL,选填 "menuType":"0", //分组菜单,0-非分组菜单,1-分组菜单,默认0,选填 "urlType":"0", //URL类型,0-相对路径,1-绝对路径,选填,当 menuUrl 不为空时,此处必填 "menuIcon":"layui-icon", //菜单图片,选填 "menuSort":1, //菜单顺序,必填 "menuType":"0", //菜单类型,0-系统菜单,1-标准业务菜单,2-IBMS菜单,3-APP菜单,必填 "extraMenu":{"disable":true} //菜单额外字段,json格式,选填 "remark":"一级菜单备注" //备注,选填 } 返回: { "content": "ME1371761303924879361", "respCode": "00000", "respMsg": "保存成功" } ### 更新菜单信息 URL:http://develop.persagy.com/integrated-platform/saas-account/menu/updateSaasMenu Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"1371374894051352577", //菜单ID,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "parentId":"", //上级菜单ID,选填 "productId":"PD1371370289309515257", // 产品ID,选填 "menuCode":"1001", //菜单编码,必填 "menuName":"一级菜单", //菜单名称,必填 "menuUrl":"/query/list", //菜单URL,选填 "menuType":"0", //分组菜单,0-非分组菜单,1-分组菜单,默认0,选填 "urlType":"0", //URL类型,0-相对路径,1-绝对路径,选填,当 menuUrl 不为空时,此处必填 "menuIcon":"layui-icon", //菜单图片,选填 "menuSort":1, //菜单顺序,必填 "menuType":"0", //菜单类型,0-系统菜单,1-标准业务菜单,2-IBMS菜单,3-APP菜单,必填 "extraMenu":{"disable":true} //菜单额外字段,json格式,选填 "remark":"一级菜单备注" //备注,选填 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 删除菜单信息 级联删除菜单下功能点,及角色-菜单功能关联关系 URL:http://develop.persagy.com/integrated-platform/saas-account/menu/deleteSaasMenu Method:POST Header:Content-Type=application/json 请求: { "id":"ME1372505865173700610", //菜单ID,必填 "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "groupCode":"TEST" //集团编码,必填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 功能点管理 ### 查询菜单下权限信息 URL:http://develop.persagy.com/integrated-platform/saas-account/function/queryMenuFunctionList Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC1372371635352403969", //当前账号ID,必填,做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,必填,做为sql条件 "groupCode":"", //集团编码,选填 "projectId":"", //项目ID,存在,即为项目视角 "productId":"PD1390234244466438145", //产品ID,选填 "menuId":"ME1372501618212643050", //菜单ID,必填 "showPageAuth":false //当返回产品页面树结果集时,是否展示产品页面的功能点信息,true-展示,默认false } 返回: // 返回样式一:返回功能点信息结果集 { "content": [ { "createTime": 1618855281000, "funCode": "101004", "funName": "查询平台管理员", "funUrl": "/account/queryAccountPageList", "id": "FU1372501618212832063", "menuId": "ME1372501618212643050", "remark": "查询平台管理员", "updateTime": 1618855281000, "updateUser": "AC1372371635352403969" } ], "respCode": "00000", "respMsg": "success" } // 返回样式二:返回产品页面树信息结果集 { "content": [ // 内容为产品页面集合 { "childrens": [], // 此页面的下级子页面 "createTime": 1620294028000, "id": "PA1390240032173895682", "pageAngle": "0", //页面视角,0-集团项目页,1-集团独有页,2-项目独有页 "pageFloor": "0", //是否为落地页,0-非落地页,1-集团落地页,2-项目落地页,3-集团项目落地页 "pageIcon": "", "pageName": "测试页面", "pageLevel": 1, "pageUrl": "", "parentId": "", "productId": "PD1390234244466438145", "remark": "测试但是", "updateTime": 1620294028000 } ], "respCode": "00000", "respMsg": "success" } ### 查询功能点信息 URL:http://develop.persagy.com/integrated-platform/saas-account/function/querySaasFunctionList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "menuId":"", //菜单ID,选填 "funCode":"1001", //功能编码,选填 "funName":"查询", //功能名称,支持模糊查询,选填 "pageId":"PA1390235384671203330" //页面ID } 返回: { "content": [ { "createTime": 1620300248000, "funCode": "1001", "funName": "查询", "funUrl": "/789/456", "id": "FU1390266121168408578", "menuId": "", "remark": "查询", "updateTime": 1620300362000, "updateUser": "AC1372371635352403969" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 角色菜单功能点列表查询 说明:接口返回数据会包括,此角色下所有被分配的功能点信息集合,以及未有功能点的菜单信息集合,均平铺返回 URL:http://develop.persagy.com/integrated-platform/saas-account/function/querySaasRoleFunctions Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,做为sql条件 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,必填,不做为sql条件 "groupCode":"sybs", //集团编码,选填 "roleId":"RO1377815673866051586" //角色ID,必填 } 返回: { "content": { "menus":[ { "appId": "PC", "id": "ME1372505574210636732", "menuCode": "1001", "menuId": "ME1372505574210636732", "menuName": "通讯录", "menuSort": 1, "menuType": "1", "menuUrl": "/address-book", "remark": "通讯录", "urlType": "0" }, ], "functions":[] }, "respCode": "00000", "respMsg": "success" } ### 创建功能点信息 URL:http://develop.persagy.com/integrated-platform/saas-account/function/createSaasFunction Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "menuId":"1371376123917754369", //菜单ID,与页面ID,二者必填其一 "pageId":"", //页面ID,与菜单ID,二者必填其一 "productId":"", //产品ID,当页面ID存在时,产品ID不可为空 "funCode":"1001010102", //功能编码,必填 "funName":"删除", //功能名称,必填 "funUrl":"/account/deleteSaasAccount", //功能URL,必填 "funSort":1, //功能顺序,必填 "remark":"功能点备注信息" //备注 } 返回: { "content": "FU1371761303924879361", "respCode": "00000", "respMsg": "保存成功" } ### 更新功能点信息 URL:http://develop.persagy.com/integrated-platform/saas-account/function/updateSaasFunction Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"FU1371635736550330370", //功能ID,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填 "menuId":"1371376123917754369", //菜单ID,与页面ID,二者必填其一 "pageId":"", //页面ID,与菜单ID,二者必填其一 "productId":"", //产品ID,当页面ID存在时,产品ID不可为空 "funCode":"1001010102", //功能编码,必填 "funName":"删除", //功能名称,必填 "funUrl":"/account/deleteSaasAccount", //功能URL,必填 "remark":"功能点备注信息" //备注 } 返回: { "respCode": "00000", "respMsg": "更新成功" } ### 删除功能点信息 URL:http://develop.persagy.com/integrated-platform/saas-account/function/deleteSaasFunction Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "id":"FU1371635736550330370", //功能点ID,必填 "accountId":"1371370289309515777", //当前账号ID,必填 "appId":"PC" //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为SQL条件 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 账号-集团区域项目管理 ### 账号-集团项目统计列表分页查询(根据账号做数据权限过滤) URL:http://develop.persagy.com/integrated-platform/saas-account/accountProject/querAccountProjectTotal Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"1", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "accountId":"AC1377877457683660802", //当前账号ID,必填,做为sql条件 "groupCode":"sybs", //集团编码,选填 "page":1, //分页页码,不可低于1,必填 "size":10 //分页大小,不可低于1,必填 } 返回: { "content": [ { "accountBelong": "1", "accountSource": "persagy", "accountType": "2", "appId": "PC", "createTime": 1617292800000, "groupCode": "sybs", "groupName": "啥也不是", "groups": [ { "createTime": 1617292800000, "groupCode": "sybs", "groupName": "啥也不是", "syncState": "2", "updateTime": 1617292800000, "updateUser": "AC1372371635352403969", "valid": 1 } ], "id": "AC1377868242034458626", "mail": "111@qq.com", "phoneNum": "18610777465", "projectNum": 0, "updateTime": 1617292800000, "updateUser": "AC1377819021444931585", "username": "xiaoxiao10", "valid": 1, "validEndTime": 1640880000000, "validLast": "0", "validStartTime": 1617292800000 } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 查询账号-集团区域项目关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountProject/querySaasAccountProjectList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "accountId":"AC1374999923417702402", //当前账号ID,必填,做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"QKZZ", //集团编码,选填 "areaId":"AR1381514340082958337", //区域ID,选填 "projectId":"PR1371761303924879361" //项目ID,选填 } 返回: { "content": [ { "accountId": "AC1374999923417702402", "projectId":"PR1371761303924879361", "groupCode": "QKZZ" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 添加账号-集团区域项目关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountProject/createSaasAccountProject Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "accountId":"AC1374999923417702402", //当前账号ID,必填,做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"QKZZ", //集团编码,必填 "areaId":"AR1381514340082958337", //区域ID,必填 "projectId":"PR1371761303924879361" //项目ID,选填 } 返回: { "respCode": "00000", "respMsg": "保存成功" } ### 重置账号-集团区域项目关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountProject/resetSaasAccountProject Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "accountId":"AC1372371635352403969", //当前账号ID,必填,做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "auths": [ { "groupCode":"TEST", //集团编码,必填 "areaId":"AR1381514340082958337", //区域ID,必填 "projectId":"AR1381514340082958337" //项目ID,选填 } ] } 返回: { "respCode": "00000", "respMsg": "重置成功" } ### 删除账号-集团项目关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountProject/deleteSaasAccountProject Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,不做为sql条件 "accountId":"AC1374999923417702402", //当前账号ID,必填,做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"QKZZ", //集团编码,选填 "areaId":"AR1381514340082958337", //区域ID,选填 "projectId":"PR1371761303924879361" //项目ID,选填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 账号-角色权限管理 ### 查询账号-角色关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountRole/querySaasRoleMenuList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,选填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,选填 "roleId":"RO1372505156457959425", //角色ID,选填 "roleIds":["RO1372505156457959425"], //角色ID集合,选填 "accountIds":[ //账号ID集合,选填,返回结果是一条条的记录,而非按照账号ID聚合 "AC1372371635352403969" ] } 返回: { "content": [ { "accountId": "AC1372371635352403969", "groupCode": "TEST", "roleId": "RO1372505156457959425" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 新增账号-角色关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountRole/createSaasAccountRole Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleId":"RO1372505156457959425" //角色ID,必填 } 返回: { "respCode": "00000", "respMsg": "保存成功" } ### 重置账号-角色关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountRole/resetSaasAccountRole Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填,做为sql条件 "accountId":"AC1375000220760301569", //当前账号ID,必填,做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"03", //集团编码,accountBelong为业务账号时,必填 "casType":"0" //关联类型,0-主岗,1-副岗,2-业务超管默认角色,选填,这里的关联类型,会作为重置的条件,进行删除数据的依据 "roles": [ //角色集合,必填 { "roleId":"RO0134568781001", //角色ID,必填 "casType":"0" //关联类型,0-主岗,1-副岗,2-业务超管默认角色,选填,这里关联类型会直接插入数据库中,不做为重置的条件 } ] } 返回: { "respCode": "00000", "respMsg": "重置成功" } ### 删除账号-角色关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/accountRole/deleteSaasAccountRole Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,选填 "roleId":"RO1372505156457959425" //角色ID,选填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 角色-菜单功能权限管理 ### 查询角色-菜单功能关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/roleMenu/querySaasRoleMenuList Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleId":"RO1371761303924879361", //角色ID,选填 "menuId":"1371376123917754369", //菜单ID,选填 "pageId":"PA1390240032173895682", //页面ID,选填 "functionId":"FU1371634297690148866" //功能ID,选填 } 返回: { "content": [ { "functionId": "FU1371634297690148866", "groupCode": "TEST", "menuId": "1371376123917754369", "pageId":"PA1390240032173895682", "roleId": "RO1371761303924879361" } ], "count": 1, "respCode": "00000", "respMsg": "success" } ### 新增角色-菜单关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/roleMenu/createSaasRoleMenu Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleId":"RO1371761303924879361", //角色ID,必填 "menuId":"ME1371639941642178563", //菜单ID,必填 "functionId":"FU1371635736550330370" //功能ID,选填 } 返回: { "respCode": "00000", "respMsg": "保存成功" } ### 重置角色-菜单关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/roleMenu/resetSaasRoleMenu Method:POST Header:Content-Type=application/json 请求: // 先删后新增,仅删除此角色下的所有菜单功能点的关联关系,并重新新增 { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleId":"RO1371761303924879362", //角色ID,必填 "auths": [ //菜单功能集合,必填 { "menuId":"1371376123917754369", //菜单ID,必填 "functionId":"1371376123917754369" //功能ID,选填 }, { "menuId":"1371376123917754369", //菜单ID,必填 "functionId":"1371376123917754380" //功能ID,选填 } ] } 返回: { "respCode": "00000", "respMsg": "重置成功" } ### 重置角色-菜单页面关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/roleMenu/resetSaasRoleMenuPage Method:POST Header:Content-Type=application/json 请求: // 先删后新增,删除此角色下的所有菜单功能点的关联关系,并重新新增 { "accountId":"AC1372371635352403969", //当前账号ID,必填 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleId":"RO1384058727954395138", //角色ID,必填 "auths": [ //菜单功能集合,必填 { "menuId":"ME1392810147536998402" //菜单ID,必填 }, { "menuId":"ME1392810243204878338", //菜单ID,必填 "pages":[] // 选填 }, { "menuId":"ME1372505574210636732", // 菜单ID,必填 "pages":[ // 权限集合,选填 { "pageId":"PA1390240032173895682", //页面ID,选填 "functionId":"FU1372509049900339201" //功能ID,选填 }, { "pageId":"PA1390240032173895682", //页面ID,选填 "functionId":"FU1372509049900339202" //功能ID,选填 } ] } ] } 返回: { "respCode": "00000", "respMsg": "重置成功" } ### 删除角色-菜单关联信息 URL:http://develop.persagy.com/integrated-platform/saas-account/roleMenu/deleteSaasRoleMenu Method:POST Header:Content-Type=application/json 请求: { "accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填 "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 "appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填,不做为sql条件 "groupCode":"TEST", //集团编码,必填 "roleId":"RO1371761303924879362", //角色ID,选填 "menuId":"1371376123917754369", //菜单ID,选填 "pageId":"PA1390240032173895682", //页面ID,选填 "functionId":"1371376123917754369" //功能ID,选填 } 返回: { "respCode": "00000", "respMsg": "删除成功" } ## 迭代-升级接口管理 说明:此下面所有的接口,均在每次提测后第一次部署成功后,执行,除此之外,均不需要执行 ### 新增区域权限表,兼容老数据接口 说明:此接口,必须返回成功,成功样例如下响应所示,否则请再次执行 URL:http://develop.persagy.com/integrated-platform/saas-account/upgrade/updateAccountAreaAuth Method:POST Header:Content-Type=application/json 请求: { "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 } 返回: { "respCode": "00000", "respMsg": "success" } ### 清除redis中的账号token值,兼容老数据接口 说明:此接口,必须返回成功,成功样例如下响应所示,否则请再次执行 URL:http://develop.persagy.com/integrated-platform/saas-account/upgrade/clearRedisCache Method:POST Header:Content-Type=application/json 请求: { "accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件 } 返回: { "respCode": "00000", "respMsg": "success" } ## 三方账号对接管理 ### 申请授权码 URL:http://develop.persagy.com/integrated-platform/saas-account/authCenter/code Method:POST Header:Content-Type=application/json 请求: { "clientId":"RGF4RHUYTJMNRWH4N" // 授权三方机构标识ID,由运维平台在对接时颁发,必填 } 返回: { "content": { "code":"123", //一次性的code值,后续获取token时使用 }, "respCode": "00000", "respMsg": "success" } ### 根据授权码获取token URL:http://develop.persagy.com/integrated-platform/saas-account/authCenter/codeToken Method:POST Header:Content-Type=application/json 请求: { "code":"123", //一次性的授权码,必填 "clientId":"RGF4RHUYTJMNRWH4N" // 授权三方机构标识ID,由运维平台在对接时颁发,必填 } 返回: { "content": { "token":"31430ad51fd0c5b1c66dd8ba382cc33392974cc138dea908.F4B702C0FE3AE2F8DCE6443B434BD26E", //格式:授权信息.token "expire": "60" //token有效期,单位:分钟 }, "respCode": "00000", "respMsg": "success" } ### 账号注册-RabbitMQ消息 ## 字典数据管理 ### 获取所有的字典类型 URL:http://develop.persagy.com/integrated-platform/saas-account/common/dictType Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC12364465864128565215" // 账号ID,必填 } 返回: { "content": { "PROJECT_FUN_TYPE": "项目功能类型", "WEATHER_TYPE": "气候区类型" }, "respCode": "00000", "respMsg": "success" } ### 获取字典类型数据 URL:http://develop.persagy.com/integrated-platform/saas-account/common/dict Method:POST Header:Content-Type=application/json 请求: { "accountId":"AC12364465864128565215", // 账号ID,必填 "dictType":"WEATHER_TYPE" // 字典类型,必填 } 返回: // 根据dictType的不同,返回值,分别如下: dictType: WEATHER_TYPE // 气候区类型 { "content": [ { "code": "10", "name": "严寒地区" }, { "code": "20", "name": "寒冷地区" }, { "code": "30", "name": "夏热冬冷地区" }, { "code": "40", "name": "夏热冬暖地区" }, { "code": "50", "name": "温和地区" }, { "code": "00", "name": "其他地区" } ], "respCode": "00000", "respMsg": "success" } dictType: PROJECT_FUN_TYPE // 项目功能类型 { "content": [ { "code": "100", "name": "居住项目" }, { "code": "200", "name": "办公项目" }, { "code": "300", "name": "教育项目" }, { "code": "400", "name": "科研项目" }, { "code": "500", "name": "金融项目" }, { "code": "600", "name": "观演项目" }, { "code": "700", "name": "文化项目" }, { "code": "800", "name": "博览项目" }, { "code": "900", "name": "游乐休闲项目" }, { "code": "A00", "name": "旅馆项目" }, { "code": "B00", "name": "商业项目" }, { "code": "C00", "name": "体育项目" }, { "code": "D00", "name": "医疗项目" }, { "code": "E00", "name": "宗教项目" }, { "code": "F00", "name": "市政项目" }, { "code": "G00", "name": "邮电媒体项目" }, { "code": "H00", "name": "司法项目" }, { "code": "I00", "name": "福利项目" }, { "code": "J00", "name": "殡葬项目" }, { "code": "K00", "name": "交通项目" }, { "code": "L00", "name": "仓储物流项目" }, { "code": "M00", "name": "工业项目" }, { "code": "N00", "name": "综合项目" }, { "code": "000", "name": "人防项目" }, { "code": "P00", "name": "园区项目" }, { "code": "Z00", "name": "其他项目" } ], "respCode": "00000", "respMsg": "success" }