所有接口的有效响应信息都包括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/saas-platform/saas-account/saas/login
Method:POST
Header:Content-Type=application/json
请求:
{
"username":"zhangsan", //账号登录名,必填
"password":"123456", //账号密码,必填
"remember":false // 是否记住登录,true-记住,默认false
}
返回:
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/saas-platform/saas-account/saas/remember
Method:POST
Header:Content-Type=application/json
请求:
body:
//账号ID、账号用户名与集团编码,至少存在其一
{
"groupCode":"TEST", //集团编码,选填,与账户用户名同时存在,
"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/saas-platform/saas-account/account/logout
Method:POST
Header:Content-Type=application/json
请求:
{
"accountId":"AC1372371635352403969" //账号ID,必填
}
返回:
{
"respCode": "00000",
"respMsg": "退出成功"
}
URL:http://develop.persagy.com/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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": "项目备注信息",
"updateTime": 1615794390000,
"updateUser": "1371370289309515777",
"valid": 1
}
],
"count": 1, //总记录数大小
"respCode": "00000",
"respMsg": "success"
}
URL:http://develop.persagy.com/saas-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":"测试项目", //项目名称,必填
"remark":"项目备注信息" //备注,选填
}
返回:
{
"content": "PR1371761303924879361",
"respCode": "00000",
"respMsg": "保存成功"
}
URL:http://develop.persagy.com/saas-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":"测试项目", //项目名称,必填
"remark":"项目备注信息" //备注,选填
}
返回:
{
"respCode": "00000",
"respMsg": "更新成功"
}
URL:http://develop.persagy.com/saas-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/saas-platform/saas-account/account/querySaasAccountList
Method:POST
Header:Content-Type=application/json
请求:
{
"accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,选填
"groupCode":"TEST", //集团编码,选填
"accountId":"1371370289309515777", //当前账号ID,选填
"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",
"appId": "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/saas-platform/saas-account/account/queryAccountPageList
Method:POST
Header:Content-Type=application/json
请求:
{
"accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,选填
"groupCode":"sybs", //集团编码,选填
"accountId":"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",
"appId": "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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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条件
"password":"123456" //账号密码,不可为空
}
返回:
{
"respCode": "00000",
"respMsg": "密码修改成功"
}
URL:http://develop.persagy.com/saas-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/saas-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/saas-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-业务角色,选填
"roleName":"测试", //角色名称,支持模糊查询,选填
"groupCode":"TEST", //集团编码,必填
"counMenu":true, //是否统计菜单数量,true-统计,默认false
"countFunction":true, //是否统计功能点数量,true-统计,默认false
"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/saas-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/saas-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/saas-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/saas-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菜单,必填
}
返回:
{
"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/saas-platform/saas-account/menu/querySaasMenuTree
Method:POST
Header:Content-Type=application/json
请求:
{
"accountBelong":"0", //账号所属, 0-运维系统账号,1-业务账号,必填
"accountId":"1371370289309515777", //当前账号ID,必填
"appId":"PC", //应用ID, PC-电脑端,APP-手机应用端,BIM-BIM平台,,必填
"isMenu":false, //是否仅查询出菜单树,true-是,默认false
"groupCode":"TEST" //集团编码,选填
}
返回:
{
"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/saas-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,选填
"menuCode":"1001", //菜单编码,必填
"menuName":"一级菜单", //菜单名称,必填
"menuUrl":"/query/list", //菜单URL,选填
"urlType":"0", //URL类型,0-相对路径,1-绝对路径,选填,当 menuUrl 不为空时,此处必填
"menuIcon":"layui-icon", //菜单图片,选填
"menuSort":1, //菜单顺序,必填
"menuType":"0", //菜单类型,0-系统菜单,1-标准业务菜单,2-IBMS菜单,3-APP菜单,必填
"remark":"一级菜单备注" //备注,选填
}
返回:
{
"content": "ME1371761303924879361",
"respCode": "00000",
"respMsg": "保存成功"
}
URL:http://develop.persagy.com/saas-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,选填
"menuCode":"1001", //菜单编码,必填
"menuName":"一级菜单", //菜单名称,必填
"menuUrl":"/query/list", //菜单URL,选填
"urlType":"0", //URL类型,0-相对路径,1-绝对路径,选填,当 menuUrl 不为空时,此处必填
"menuIcon":"layui-icon", //菜单图片,选填
"menuSort":1, //菜单顺序,必填
"menuType":"0", //菜单类型,0-系统菜单,1-标准业务菜单,2-IBMS菜单,3-APP菜单,必填
"remark":"一级菜单备注" //备注,选填
}
返回:
{
"respCode": "00000",
"respMsg": "更新成功"
}
级联删除菜单下功能点,及角色-菜单功能关联关系
URL:http://develop.persagy.com/saas-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/saas-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":"1371376123917754369", //菜单ID,选填
"funCode":"011001", //功能编码,选填
"funName":"测试功能点" //功能名称,支持模糊查询,选填
}
返回:
{
"respCode": "00000",
"respMsg": "删除成功"
}
说明:接口返回数据会包括,此角色下所有被分配的功能点信息集合,以及未有功能点的菜单信息集合,均平铺返回
URL:http://develop.persagy.com/saas-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/saas-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,必填
"funCode":"1001010102", //功能编码,必填
"funName":"删除", //功能名称,必填
"funUrl":"/account/deleteSaasAccount", //功能URL,必填
"funSort":1, //功能顺序,必填
"remark":"功能点备注信息" //备注
}
返回:
{
"content": "FU1371761303924879361",
"respCode": "00000",
"respMsg": "保存成功"
}
URL:http://develop.persagy.com/saas-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,必填
"funCode":"1001010102", //功能编码,必填
"funName":"删除", //功能名称,必填
"funUrl":"/account/deleteSaasAccount", //功能URL,必填
"funSort":2, //功能顺序,必填
"remark":"功能点备注信息" //备注
}
返回:
{
"respCode": "00000",
"respMsg": "更新成功"
}
URL:http://develop.persagy.com/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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/saas-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,选填
"accountIds":[ //账号ID集合,选填,返回结果是一条条的记录,而非按照账号ID聚合
"AC1372371635352403969"
]
}
返回:
{
"content": [
{
"accountId": "AC1372371635352403969",
"groupCode": "TEST",
"roleId": "RO1372505156457959425"
}
],
"count": 1,
"respCode": "00000",
"respMsg": "success"
}
URL:http://develop.persagy.com/saas-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/saas-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/saas-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/saas-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,选填
"functionId":"FU1371634297690148866" //功能ID,选填
}
返回:
{
"content": [
{
"functionId": "FU1371634297690148866",
"groupCode": "TEST",
"menuId": "1371376123917754369",
"roleId": "RO1371761303924879361"
}
],
"count": 1,
"respCode": "00000",
"respMsg": "success"
}
URL:http://develop.persagy.com/saas-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/saas-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/saas-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,选填
"functionId":"1371376123917754369" //功能ID,选填
}
返回:
{
"respCode": "00000",
"respMsg": "删除成功"
}
说明:此下面所有的接口,均在每次提测后第一次部署成功后,执行,除此之外,均不需要执行
说明:此接口,必须返回成功,成功样例如下响应所示,否则请再次执行
URL:http://develop.persagy.com/saas-platform/saas-account/upgrade/updateAccountAreaAuth
Method:POST
Header:Content-Type=application/json
请求:
{
"accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件
}
返回:
{
"respCode": "00000",
"respMsg": "success"
}
说明:此接口,必须返回成功,成功样例如下响应所示,否则请再次执行
URL:http://develop.persagy.com/saas-platform/saas-account/upgrade/clearRedisCache
Method:POST
Header:Content-Type=application/json
请求:
{
"accountId":"1371370289309515777", //当前账号ID,必填,不做为sql条件
}
返回:
{
"respCode": "00000",
"respMsg": "success"
}