數(shù)字政府應(yīng)用服務(wù)規(guī)范 第3部分：組織身份服務(wù)接口規(guī)范（征求意見稿）

T/ZGCSA1.3-2023數(shù)字政府應(yīng)用服務(wù)規(guī)范第3部分：組織身份服務(wù)接口規(guī)范本文件適用于全國各級黨政機關(guān)、企事業(yè)單位、國土、財政、水利、統(tǒng)計等行業(yè)以及NGO的信息系統(tǒng)規(guī)劃、建設(shè)，以及系統(tǒng)集成商、軟件開發(fā)商和監(jiān)理單位進(jìn)行數(shù)字政府信息系統(tǒng)的開發(fā)與整合。在涉及國家秘密的信息系統(tǒng)規(guī)劃、建設(shè)中，需參照《涉及國家秘密的信息系統(tǒng)分級保護(hù)管理辦法》和相關(guān)標(biāo)準(zhǔn)、規(guī)定。2規(guī)范性引用文件下列文件中的條款通過本部分的引用而成為本部分的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本部分，然而，鼓勵根據(jù)本部分達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本部分。GB/T13016—1991標(biāo)準(zhǔn)體系表編制原則和要求GB/T19488.1—2004電子政務(wù)數(shù)據(jù)元第1部分:設(shè)計和管理規(guī)范GB/T20000.1—2002標(biāo)準(zhǔn)化工作指南第1部分：標(biāo)準(zhǔn)化和相關(guān)活動的通用術(shù)語GB/T21062.1—2007政務(wù)信息資源交換體系第1部分：總體框架GB/T21063.1—2007政務(wù)信息資源目錄體系第1部分:總體框架GB/T21064—2007電子政務(wù)系統(tǒng)總體設(shè)計要求3作用規(guī)范組織身份服務(wù)的管理接口使應(yīng)用系統(tǒng)以統(tǒng)一的方式獲取組織身份信息。應(yīng)用系統(tǒng)只需關(guān)注業(yè)務(wù)流程及業(yè)務(wù)邏輯的設(shè)計，認(rèn)證、組織身份信息均可以由組織身份服務(wù)接口獲得。組織身份服務(wù)以組織身份模型為數(shù)據(jù)來源，為訪問控制服務(wù)、單點登錄服務(wù)等提供運行支撐。4接口定義4.1人員管理4.1.1新增人員接口URL：:8443/platform/services/rest/person/createPerson請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述2T/ZGCSA1.3-2023名稱類型描述tenantIdstringpjson返回值說明stringNocommentsfound.名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string登錄名稱string密碼string人員頭像int32編制名稱T/ZGCSA1.3-2023名稱類型描述stringstringint32stringstringstringint32stringstringstringstringstringstringstringstringstringstringbooleanstringbooleanint32編制類型職務(wù)職級職級名稱CA認(rèn)證碼性別人員籍貫辦公室地址辦公室電話電話傳真手機號擁有的崗位列表當(dāng)前的崗位Id人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用戶:expertPerson排序序列號是否原始人員，0:添加的人員，1：新增的人員原始人員id是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員4.1.2刪除人員接口URL：:8443/platform/services/rest/person/deleteById4T/ZGCSA1.3-2023請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述tenantIdstringpersonId返回值說明string名稱類型描述successcodemsgdata4.1.3更新人員booleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)接口URL：:8443/platform/services/rest/person/savePerson請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringpjson返回值說明stringNocommentsfound.名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringT/ZGCSA1.3-2023名稱類型描述object創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string登錄名稱string密碼string人員頭像int32編制名稱string編制類型string職務(wù)int32職級string職級名稱stringCA認(rèn)證碼stringint32性別string人員籍貫string辦公室地址string辦公室電話string電話傳真T/ZGCSA1.3-2023名稱類型描述stringstringstringstringstringstringbooleanstringbooleanint324.1.4改變?nèi)藛T的禁用狀態(tài)手機號擁有的崗位列表當(dāng)前的崗位Id人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用戶:expertPerson排序序列號是否原始人員，0:添加的人員，1：新增的人員原始人員id是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員:8443/platform/services/rest/person/changeDisabled請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringpersonId返回值說明string名稱類型描述successboolean操作是否成功T/ZGCSA1.3-2023名稱類型描述codeint32錯誤代碼msgstring錯誤信息databoolean返回的數(shù)據(jù)4.1.5檢查登錄名是否存在:8443/platform/services/rest/person/checkLoginName請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述personIdstringloginName返回值說明string登錄名名稱類型描述successcodemsgdatabooleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)4.1.6獲取父節(jié)點下的全部人員:8443/platform/services/rest/person/findAllByParentId請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述tenantIdparentIddisabledstringstringboolean是否禁用T/ZGCSA1.3-2023名稱類型描述pageint32頁號rowsint32條數(shù)返回值說明字段類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)int32當(dāng)前頁int32總頁數(shù)int64總條數(shù)array數(shù)據(jù)項string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔T/ZGCSA1.3-2023字段類型描述string登錄名稱string密碼string人員頭像編制名稱string編制類型string職級名稱stringint32性別人員籍貫string辦公室地址辦公室電話電話傳真string手機號string擁有的崗位列表string當(dāng)前的崗位Id└─personTypestring人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用戶:expertPerson排序序列號是否原始人員，0:添加的人員，1：新增字段4.1.7獲取全部人員類型stringbooleanint32int64stringbooleanT/ZGCSA1.3-2023描述的人員原始人員id是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員錯誤代碼調(diào)用信息操作是否成功:8443/platform/services/rest/person/getAllPersonsHTTP請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述tenantId返回值說明string名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間T/ZGCSA1.3-2023名稱類型描述boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string登錄名稱string密碼string人員頭像int32編制名稱string編制類型string職務(wù)int32職級string職級名稱stringCA認(rèn)證碼stringint32性別string人員籍貫string辦公室地址string辦公室電話string電話傳真string手機號string擁有的崗位列表T/ZGCSA1.3-2023名稱類型描述stringstringbooleanstringbooleanint324.1.8獲取人員所在用戶組列表當(dāng)前的崗位Id人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用戶:expertPerson排序序列號是否原始人員，0:添加的人員，1：新增的人員原始人員id是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理員，2：安全保密員，3：安全審計員，4：云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員接口URL：:8443/platform/services/rest/person/getGroups請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringpersonId返回值說明string人員唯一標(biāo)識名稱類型描述successcodemsgdatabooleanint32stringarray操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)T/ZGCSA1.3-2023名稱類型描述string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string崗位組或者用戶組4.1.9獲取人員父節(jié)點接口URL：:8443/platform/services/rest/person/getParent請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述tenantIdstringpersonId返回值說明string人員唯一標(biāo)識名稱類型描述successboolean操作是否成功T/ZGCSA1.3-2023名稱類型描述codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔4.1.10根據(jù)人員id獲取人員擴(kuò)展信息:8443/platform/services/rest/person/getPersonExtByPersonId請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdpersonIdstringstring租戶人員T/ZGCSA1.3-2023返回值說明名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)object創(chuàng)建時間object更新時間object出生日期string居住國家string證件類型string證件號碼string人員籍貫string家庭地址string家庭電話string政治面貌string學(xué)歷int32婚姻狀況string專業(yè)object入職時間4.1.11獲取人員所在崗位列表接口URL：:8443/platform/services/rest/person/getPositionsT/ZGCSA1.3-2023請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringpersonId返回值說明string人員唯一標(biāo)識名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string職務(wù)類型T/ZGCSA1.3-2023名稱類型描述string職級名稱int32職級string職務(wù)string類型stringNocommentsfound.4.2角色管理4.2.1新增人員到角色接口地址：:8443/platform/services/rest/role/addPerson請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述personIdstringroleIdstringtenantId返回值說明string人員所在的租戶id名稱類型描述successcodemsgdatabooleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)4.2.2新增角色（帶自定義標(biāo)示customId）接口地址：:8443/platform/services/rest/role/createRoleNodeAddCustomId請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述roleNameparentIdcustomIdtypesystemNamesystemCnName返回值說明名稱stringstringstringstringstringstring類型T/ZGCSA1.3-2023角色名稱父節(jié)點idcustomId對應(yīng)工作流的processDefineKey角色類型，role：角色，folder：文件夾系統(tǒng)標(biāo)識系統(tǒng)中文名稱描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一主鍵stringstring名稱object創(chuàng)建時間string描述string繼承關(guān)系string類型int32排序號string擴(kuò)展屬性string父節(jié)點string系統(tǒng)標(biāo)識boolean租戶自定義stringtenantCustom=true時的租戶idboolean動態(tài)角色map擴(kuò)展屬性鍵值對4.2.3刪除角色接口地址：:8443/platform/services/rest/role/deleteRole請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8T/ZGCSA1.3-2023名稱類型描述roleId返回值說明string名稱類型描述successcodemsgdatabooleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)4.2.4根據(jù)customId和parentId獲取角色接口地址：:8443/platform/services/rest/role/findByCustomIdAndParentId請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述customIdstringcustomIdparentId返回值說明string角色的父節(jié)點id名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一主鍵stringstring名稱object創(chuàng)建時間string描述string繼承關(guān)系string類型int32排序號T/ZGCSA1.3-2023string擴(kuò)展屬性string父節(jié)點string系統(tǒng)標(biāo)識boolean租戶自定義stringtenantCustom=true時的租戶idboolean動態(tài)角色map擴(kuò)展屬性鍵值對4.2.5根據(jù)角色I(xiàn)d獲取角色下所有人員（遞歸）接口地址：:8443/platform/services/rest/role/getAllPersonsById請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringroleId返回值說明string角色唯一標(biāo)識字段類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱stringstringstringint32stringstringstringstringint32stringstringint32stringstringstringint32stringstringstringstringstringstringstringstringstringstringstringbooleanstringbooleanint32T/ZGCSA1.3-2023名稱機構(gòu)類型擴(kuò)展屬性（json格式）序號由ID組成的父子關(guān)系列表，之間用逗號分隔登錄名稱密碼人員頭像編制名稱編制類型職務(wù)職級職級名稱CA認(rèn)證碼性別人員籍貫辦公室地址辦公室電話電話傳真手機號擁有的角色列表擁有的崗位列表當(dāng)前的崗位Id人員類型。管理員用戶：adminPerson，戶:userPerson，專家用戶:expertPerson排序序列號是否原始人員，0:添加的人員，1：新增的人員原始人員id是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理T/ZGCSA1.3-2023云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員4.2.6根據(jù)角色I(xiàn)d獲取相應(yīng)OrgUnits接口說明：是指獲取角色所包含的機構(gòu)、部門、人員、崗位、組。接口地址：:8443/platform/services/rest/role/getOrgUnitsById請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringroleIdstring角色唯一標(biāo)識orgType返回值說明string機構(gòu)類型名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號stringT/ZGCSA1.3-2023由ID組成的父子關(guān)系列表，之間用逗號分隔4.2.7根據(jù)角色I(xiàn)d獲取相應(yīng)人員接口地址：:8443/platform/services/rest/role/getPersonsById請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明參數(shù)名稱類型描述tenantIdstringroleId返回值說明string角色唯一標(biāo)識字段類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string登錄名稱string密碼T/ZGCSA1.3-2023string人員頭像int32編制名稱string編制類型└─dutyLevelint3└─dutyLevelNamestring職級名稱CA認(rèn)證碼string人員籍貫string辦公室地址string辦公室電話string電話傳真string手機號string擁有的角色列表string擁有的崗位列表string當(dāng)前的崗位Id人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用戶:expertPerson└─orderedPathstring排序序列號└─originalboolean是否原始人員，0:添加的人員，1：新增的人員└─originalIdstring原始人員└─tenantManagerboolean是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理└─managerLevelint32員，2：安全保密員，3：安全審計員，4：云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員4.2.8根據(jù)人員id獲取所有關(guān)聯(lián)的角色接口地址：:8443/platform/services/rest/role/getRelateRoleByPersonId請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8T/ZGCSA1.3-2023參數(shù)說明名稱類型描述tenantIdstringpersonId返回值說明string名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一主鍵stringstring名稱object創(chuàng)建時間string描述string繼承關(guān)系string類型int32排序號string擴(kuò)展屬性string父節(jié)點string系統(tǒng)標(biāo)識boolean租戶自定義stringtenantCustom=true時的租戶idboolean動態(tài)角色map擴(kuò)展屬性鍵值對4.2.9根據(jù)id獲取相應(yīng)角色節(jié)點接口地址：:8443/platform/services/rest/role/getRole請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述roleIdstring角色唯一標(biāo)識返回值說明T/ZGCSA1.3-2023名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一主鍵stringstring名稱object創(chuàng)建時間string描述string繼承關(guān)系string類型int32排序號string擴(kuò)展屬性string父節(jié)點string系統(tǒng)標(biāo)識boolean租戶自定義stringtenantCustom=true時的租戶idboolean動態(tài)角色map擴(kuò)展屬性鍵值對4.2.10根據(jù)orgUnitId獲取角色節(jié)點接口地址：:8443/platform/services/rest/role/getRoleByOrgUnitId請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringorgUnitId返回值說明string機構(gòu)節(jié)點id名稱類型描述successboolean操作是否成功T/ZGCSA1.3-2023codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)object創(chuàng)建時間string描述string繼承關(guān)系int32排序號string擴(kuò)展屬性string父節(jié)點string系統(tǒng)標(biāo)識boolean租戶自定義stringtenantCustom=true時的租戶idboolean動態(tài)角色map擴(kuò)展屬性鍵值對4.2.11根據(jù)父節(jié)點Id獲取相應(yīng)子級角色節(jié)點接口地址：:8443/platform/services/rest/role/getRoleByParentId請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述roleIdstring角色唯一標(biāo)識名稱類型描述successcodemsgdatabooleanint32stringarray操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)T/ZGCSA1.3-2023object創(chuàng)建時間string描述string繼承關(guān)系int32排序號string擴(kuò)展屬性string父節(jié)點string系統(tǒng)標(biāo)識boolean租戶自定義stringtenantCustom=true時的租戶idboolean動態(tài)角色map擴(kuò)展屬性鍵值對4.2.12根據(jù)系統(tǒng)標(biāo)識獲取該系統(tǒng)的角色樹的頂級節(jié)點接口地址：:8443/platform/services/rest/role/getRootRoleBySystemName請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述systemName返回值說明string系統(tǒng)標(biāo)識名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一主鍵stringstring名稱T/ZGCSA1.3-2023object創(chuàng)建時間string描述string繼承關(guān)系int32排序號string擴(kuò)展屬性string父節(jié)點string系統(tǒng)標(biāo)識boolean租戶自定義stringtenantCustom=true時的租戶idboolean動態(tài)角色map擴(kuò)展屬性鍵值對4.2.13根據(jù)人員id判斷其是否擁有roleName這個角色接口地址：:8443/platform/services/rest/role/hasRole請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述tenantIdstringsystemNamestring系統(tǒng)標(biāo)識propertiesstring角色擴(kuò)展屬性roleNamestring角色名稱personId返回值說明string名稱類型描述successcodemsgdatabooleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)4.2.14判斷orgUnitId是否有角色roleIdT/ZGCSA1.3-2023接口地址：:8443/platform/services/rest/role/hasRoleByTenantIdAndRoleIdAndOrgUnitId請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringroleIdstringorgUnitId返回值說明string機構(gòu)節(jié)點id名稱類型描述successcodemsgdatabooleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)4.2.15刪除角色中的人員接口地址：:8443/platform/services/rest/role/removePerson請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8名稱類型描述personIdstringroleIdstringtenantId返回值說明string人員所在的租戶id名稱類型描述successcodemsgdatabooleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)T/ZGCSA1.3-20234.3部門管理4.3.1新建部門:8443/platform/services/rest/department/createDepartment請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartmentJson返回值說明string部門JSON字符串名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）T/ZGCSA1.3-2023名稱類型描述└─tabIndexint3└─guidPathstring由ID組成的父子關(guān)系列表，之間用逗號分隔string部門簡稱string特定名稱string英文名稱string等級編碼string區(qū)域代碼string部門地址string辦公室string傳真號碼string電話號碼string郵政編碼object成立時間boolean是否委辦局4.3.2刪除部門:8443/platform/services/rest/department/deleteDepartment請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartmentId返回值說明stringNocommentsfound.名稱類型描述successcodebooleanint32操作是否成功錯誤代碼T/ZGCSA1.3-2023名稱類型描述msgstring錯誤信息databoolean返回的數(shù)據(jù)4.3.3更新部門:8443/platform/services/rest/department/saveDepartment請求方法：POSTContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartment返回值說明stringNocommentsfound.名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱T/ZGCSA1.3-2023名稱類型描述└─orgTypestring機構(gòu)類型└─propertiesstring擴(kuò)展屬性（json格式）└─guidPathstring由ID組成的父子關(guān)系列表，之間用逗號分隔string部門簡稱string特定名稱string英文名稱string等級編碼string區(qū)域代碼string部門地址string辦公室string傳真號碼string電話號碼string郵政編碼object成立時間boolean是否委辦局4.3.4禁用部門:8443/platform/services/rest/department/disableDepartment請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartmentId返回值說明string名稱類型描述T/ZGCSA1.3-2023名稱類型描述successcodemsgdatabooleanint32stringboolean操作是否成功錯誤代碼錯誤信息返回的數(shù)據(jù)4.3.5獲取部門下的所有人員(遞歸，包含部門下對應(yīng)的人員):8443/platform/services/rest/department/getAllPersons請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartmentId返回值說明string名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringT/ZGCSA1.3-2023名稱類型描述string域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string登錄名稱string密碼string人員頭像int32編制名稱string編制類型string職務(wù)int32職級string職級名稱stringCA認(rèn)證碼stringint32性別string人員籍貫string辦公室地址string辦公室電話string電話傳真string手機號string擁有的崗位列表string當(dāng)前的崗位Idstring人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用T/ZGCSA1.3-2023名稱類型描述stringstringbooleanstringbooleanint32戶:expertPerson排序序列號是否原始人員，0:添加的人員，1：新增的人員原始人員id是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理員，2：安全保密員，3：安全審計員，4：云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員4.3.6獲取部門下的所有未禁用/禁用的人員(遞歸):8443/platform/services/rest/department/getAllPersonsByDisabled請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartmentIdstringdisabled返回值說明boolean是否禁用名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識T/ZGCSA1.3-2023名稱類型描述string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string登錄名稱string密碼string人員頭像int32編制名稱string編制類型string職務(wù)int32職級string職級名稱stringCA認(rèn)證碼stringint32性別string人員籍貫string辦公室地址T/ZGCSA1.3-2023名稱類型描述stringstringstringstringstringstringstringstringbooleanstringbooleanint324.3.7獲取部門主管領(lǐng)導(dǎo)辦公室電話電話傳真手機號擁有的崗位列表當(dāng)前的崗位Id人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用戶:expertPerson排序序列號是否原始人員，0:添加的人員，1：新增的人員原始人員id是否租戶管理員三員類別。0：一般用戶，1：系統(tǒng)管理員，2：安全保密員，3：安全審計員，4：云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員:8443/platform/services/rest/department/getManagers請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIddepartmentId返回值說明stringstring部門唯一標(biāo)識T/ZGCSA1.3-2023字段類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔4.3.8獲取部門父節(jié)點:8443/platform/services/rest/department/getParent請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringT/ZGCSA1.3-2023名稱類型描述departmentId返回值說明string部門唯一標(biāo)識字段類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataobject返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔4.3.9獲取部門下的未禁用/禁用的人員(下一級):8443/platform/services/rest/department/getPersonsByDisabl請求方法：GETT/ZGCSA1.3-2023Content-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartmentIdstringdisabled返回值說明boolean是否禁用字段類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string登錄名稱T/ZGCSA1.3-2023字段類型描述string密碼string人員頭像int32編制名稱string編制類型string職務(wù)int32職級string職級名稱stringCA認(rèn)證碼stringint32性別string人員籍貫string辦公室地址string辦公室電話string電話傳真string手機號string擁有的崗位列表string當(dāng)前的崗位Idstring人員類型,管理員用戶：adminPerson,單位用戶：deptPerson,個人用戶:userPerson,專家用戶:expertPersonstringstring排序序列號boolean是否原始人員，0:添加的人員，1：新增的人員string原始人員idboolean是否租戶管理員int32三員類別。0：一般用戶，1：系統(tǒng)管理T/ZGCSA1.3-2023字段類型描述云系統(tǒng)管理員，5：云安全保密員，6：云安全審計員4.3.10獲取子部門(下一級):8443/platform/services/rest/department/getSubDepartments請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringdepartmentId返回值說明string部門唯一標(biāo)識名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型T/ZGCSA1.3-2023名稱類型描述└─propertiesstring擴(kuò)展屬性（json格式）└─guidPathstring由ID組成的父子關(guān)系列表，之間用逗號分隔string部門簡稱string特定名稱string英文名稱string等級編碼string區(qū)域代碼string部門地址string辦公室string傳真號碼string電話號碼string郵政編碼└─establishDateobject成立時間是否委辦局4.3.11根據(jù)條件查詢部門對象接口URL：:8443/platform/services/rest/department/search請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringwhereClause返回值說明stringsql語句where后面的條件語句名稱類型描述successcodebooleanint32操作是否成功錯誤代碼T/ZGCSA1.3-2023名稱類型描述msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string部門簡稱string特定名稱string英文名稱string等級編碼string區(qū)域代碼string部門地址string辦公室string傳真號碼string電話號碼string郵政編碼T/ZGCSA1.3-2023名稱類型描述└─establishDateobject成立時間是否委辦局4.4機構(gòu)管理4.4.1根據(jù)租戶id獲取機構(gòu)接口URL：:8443/platform/services/rest/organization/getAll請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantId返回值說明string名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型T/ZGCSA1.3-2023名稱類型描述string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string英文名稱└─organizationCodestring機構(gòu)代碼└─organizationTypestring組織機構(gòu)類型boolean機構(gòu)類型,0=實體組織，1=虛擬組織4.4.2獲取機構(gòu)下的部門（下一級）:8443/platform/services/rest/organization/getDepartments請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8參數(shù)說明名稱類型描述tenantIdstringorganizationId返回值說明string機構(gòu)唯一標(biāo)識名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間T/ZGCSA1.3-2023名稱類型描述boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔string部門簡稱string特定名稱string英文名稱string等級編碼string區(qū)域代碼string部門地址string辦公室string傳真號碼string電話號碼string郵政編碼object成立時間boolean是否委辦局4.4.3獲取用戶組（下一級）:8443/platform/services/rest/organization/getGroups請求方法：GETContent-Type：application/x-www-form-urlencoded;charset=utf-8T/ZGCSA1.3-2023參數(shù)說明名稱類型描述tenantIdstringorganizationId返回值說明string機構(gòu)唯一標(biāo)識名稱類型描述successboolean操作是否成功codeint32錯誤代碼msgstring錯誤信息dataarray返回的數(shù)據(jù)string唯一標(biāo)識string父節(jié)點IDstringobject創(chuàng)建時間object更新時間boolean是否刪除boolean是否禁用string描述stringstring域名稱string名稱string機構(gòu)類型string擴(kuò)展屬性（json格式）int32序號string由ID組成的父子關(guān)系列表，之間用逗號分隔strin