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

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