saas_platform.md 134 KB

运维管理平台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"
}