数字政府应用服务规范 第3部分：组织身份服务接口规范（征求意见稿）

ICS35.080

CCSL77

团体标准

T/ZGCSA1.3—2022

数字政府应用服务规范

第3部分：组织身份服务接口规范

DigitalGovernmentApplicationServiceSpecification—

Part3:OrganizationIdentityModelServiceAPISpecification

2022-XX-XX发布2022-XX-XX实施

中关村软件和信息服务产业创新联盟发布

T/ZGCSA1.3—2022

前言

T/ZGCSA1—2022《数字政府应用服务规范》目前分为10个部分:

——第1部分《总则》

——第2部分《组织身份模型数据规范》

——第3部分《组织身份服务接口规范》

——第4部分《电子表单服务接口规范》

——第5部分《业务流程服务接口规范》

——第6部分《应用服务运行管理框架规范》

——第7部分《单点登录服务接口规范》

——第8部分《访问控制服务接口规范》

——第9部分《应用系统分类及代码规范》

——第10部分《应用系统描述规范》

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规

定起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由北京有生博大软件股份有限公司提出。

本文件由中关村软件和信息服务产业创新联盟归口。

本文件由北京有生博大软件股份有限公司、北京有生深境技术有限公司、北京中扬天成科技有限公

司、北京国信宏大科技有限公司、北京远光通联科技有限公司、北京国联天成信息技术有限公司、山东

微创软件、北京兰云科技有限公司、北京北大英华科技有限公司、中电信源科技发展(北京)有限公司、

北京中标文通信息技术有限公司、北京蓝工科技有限公司、长城计算机软件与系统有限公司、中民智金

科技股份有限公司共同起草。

本文件主要起草人：王克照、郑大春、丁兆俊、唐楠、高丽、王洪哲、秦漫、杜承霖、万闵敏、蒙

菊花、施道棒、张重洁、易洪、喻成全、高泽、门嘉平、葛春波、易建超、王继、赵晓海、瞿敏、马东

晖、杨川、李东、张子煊、庞智仁等。

II

T/ZGCSA1.3—2022

数字政府应用服务规范

第3部分：组织身份服务接口规范

1范围

本文件适用于全国各级党政机关、企事业单位、国土、财政、水利、统计等行业以及NGO的信息系

统规划、建设，以及系统集成商、软件开发商和监理单位进行数字政府信息系统的开发与整合。

在涉及国家秘密的信息系统规划、建设中，需参照《涉及国家秘密的信息系统分级保护管理办法》

和相关标准、规定。

2规范性引用文件

下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的

修改单（不包括勘误的内容）或修订版均不适用于本部分，然而，鼓励根据本部分达成协议的各方研究

是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。

GB/T13016—1991标准体系表编制原则和要求

GB/T19488.1—2004电子政务数据元第1部分:设计和管理规范

GB/T20000.1—2002标准化工作指南第1部分：标准化和相关活动的通用术语

GB/T21062.1—2007政务信息资源交换体系第1部分：总体框架

GB/T21063.1—2007政务信息资源目录体系第1部分:总体框架

GB/T21064—2007电子政务系统总体设计要求

3作用

规范组织身份服务的管理接口使应用系统以统一的方式获取组织身份信息。应用系统只需关注业务

流程及业务逻辑的设计，认证、组织身份信息均可以由组织身份服务接口获得。

组织身份服务以组织身份模型为数据来源，为访问控制服务、单点登录服务等提供运行支撑。

4接口定义

4.1人员管理

4.1.1新增人员

接口URL：

:8443/platform/services/rest/person/createPerson

请求方法：POST

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

1

T/ZGCSA1.3—2022

名称类型描述

tenantIdstring租户id

pjsonstringNocommentsfound.

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataobject返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗

号分隔

└─loginNamestring登录名称

└─passwordstring密码

└─avatorstring人员头像

└─officialint32编制名称

2

T/ZGCSA1.3—2022

名称类型描述

└─officialTypestring编制类型

└─dutystring职务

└─dutyLevelint32职级

└─dutyLevelNamestring职级名称

└─caidstringCA认证码

└─emailstring邮箱

└─sexint32性别

└─provincestring人员籍贯

└─officeAddressstring办公室地址

└─officePhonestring办公室电话

└─officeFaxstring电话传真

└─mobilestring手机号

└─positionsstring拥有的岗位列表

└─positionIdstring当前的岗位Id

└─personTypestring人员类型,管理员用户：adminPerson,

单位用户：deptPerson,个人用

户:userPerson,专家用

户:expertPerson

└─weixinIdstring微信id

└─orderedPathstring排序序列号

└─originalboolean是否原始人员，0:添加的人员，1：新

增的人员

└─originalIdstring原始人员id

└─tenantManagerboolean是否租户管理员

4.1.2删除人员

接口URL：:8443/platform/services/rest/person/deleteById

请求方法：POST

Content-Type：application/x-www-form-urlencoded;charset=utf-8

3

T/ZGCSA1.3—2022

参数说明

名称类型描述

tenantIdstring租户id

personIdstring人员id

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

databoolean返回的数据

4.1.3更新人员

接口URL：:8443/platform/services/rest/person/savePerson

请求方法：POST

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

pjsonstringNocommentsfound.

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataobject返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户id

└─createTimeobject创建时间

└─updateTimeobject更新时间

4

T/ZGCSA1.3—2022

名称类型描述

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗号分隔

└─loginNamestring登录名称

└─passwordstring密码

└─avatorstring人员头像

└─officialint32编制名称

└─officialTypestring编制类型

└─dutystring职务

└─dutyLevelint32职级

└─dutyLevelNamestring职级名称

└─caidstringCA认证码

└─emailstring邮箱

└─sexint32性别

└─provincestring人员籍贯

└─officeAddressstring办公室地址

└─officePhonestring办公室电话

└─officeFaxstring电话传真

└─mobilestring手机号

└─positionsstring拥有的岗位列表

└─positionIdstring当前的岗位Id

5

T/ZGCSA1.3—2022

名称类型描述

└─personTypestring人员类型,管理员用户：adminPerson,单位用户：deptPerson,

个人用户:userPerson,专家用户:expertPerson

└─weixinIdstring微信id

└─orderedPathstring排序序列号

└─originalboolean是否原始人员，0:添加的人员，1：新增的人员

└─originalIdstring原始人员id

└─tenantManagerboolean是否租户管理员

4.1.4改变人员的禁用状态

接口URL：

:8443/platform/services/rest/person/changeDisabled

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

personIdstring人员id

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

databoolean返回的数据

4.1.5检查登录名是否存在

接口URL：

:8443/platform/services/rest/person/checkLoginName

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

6

T/ZGCSA1.3—2022

名称类型描述

personIdstring人员id

loginNamestring登录名

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

databoolean返回的数据

4.1.6获取父节点下的全部人员

接口URL：

:8443/platform/services/rest/person/findAllByParentId

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户ID

parentIdstring部门ID

disabledboolean是否禁用

pageint32页号

rowsint32条数

返回值说明

字段类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataobject返回的数据

└─currPageint32当前页

└─totalPagesint32总页数

7

T/ZGCSA1.3—2022

字段类型描述

└─totalint64总条数

└─rowsarray数据项

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

string描述

└─description

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗号分隔

└─loginNamestring登录名称

└─passwordstring密码

└─avatorstring人员头像

└─officialint32编制名称

string编制类型

└─officialType

└─dutystring职务

└─dutyLevelint32职级

string职级名称

└─dutyLevelName

8

T/ZGCSA1.3—2022

字段类型描述

└─caidstringCA认证码

└─emailstring邮箱

└─sexint32性别

└─provincestring人员籍贯

string办公室地址

└─officeAddress

string办公室电话

└─officePhone

└─officeFaxstring电话传真

└─mobilestring手机号

└─positionsstring拥有的岗位列表

└─positionIdstring当前的岗位Id

└─personTypestring人员类型,管理员用户：adminPerson,单位用户：deptPerson,个人

用户:userPerson,专家用户:expertPerson

└─weixinIdstring微信id

string排序序列号

└─orderedPath

└─originalboolean是否原始人员，0:添加的人员，1：新增的人员

└─originalIdstring原始人员id

boolean是否租户管理员

└─tenantManager

└─codeint64错误代码

└─msgstring调用信息

└─successboolean操作是否成功

4.1.7获取全部人员

接口URL：

:8443/platform/services/rest/person/getAllPersons

HTTP请求方法：GET

9

T/ZGCSA1.3—2022

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataarray返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗号分隔

└─loginNamestring登录名称

└─passwordstring密码

└─avatorstring人员头像

└─officialint32编制名称

10

T/ZGCSA1.3—2022

名称类型描述

└─officialTypestring编制类型

└─dutystring职务

└─dutyLevelint32职级

└─dutyLevelNamestring职级名称

└─caidstringCA认证码

└─emailstring邮箱

└─sexint32性别

└─provincestring人员籍贯

└─officeAddressstring办公室地址

└─officePhonestring办公室电话

└─officeFaxstring电话传真

└─mobilestring手机号

└─positionsstring拥有的岗位列表

└─positionIdstring当前的岗位Id

└─personTypestring人员类型,管理员用户：adminPerson,单位用户：deptPerson,

个人用户:userPerson,专家用户:expertPerson

└─weixinIdstring微信id

└─orderedPathstring排序序列号

└─originalboolean是否原始人员，0:添加的人员，1：新增的人员

└─originalIdstring原始人员id

└─tenantManagerboolean是否租户管理员

4.1.8获取人员所在用户组列表

接口URL：:8443/platform/services/rest/person/getGroups

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

11

T/ZGCSA1.3—2022

名称类型描述

personIdstring人员唯一标识

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataarray返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户Id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗号

分隔

└─typestring岗位组或者用户组

4.1.9获取人员父节点

接口URL：:8443/platform/services/rest/person/getParent

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

12

T/ZGCSA1.3—2022

参数说明

名称类型描述

tenantIdstring租户id

personIdstring人员唯一标识

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataobject返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户Id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗号

分隔

4.1.10根据人员id获取人员扩展信息

接口URL：

:8443/platform/services/rest/person/getPersonExtByPersonId

13

T/ZGCSA1.3—2022

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

personIdstring人员id

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataobject返回的数据

└─idstring唯一标识

└─personIdstring人员ID

└─parentIdstring父节点ID

└─namestring名称

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─photoarray照片

└─signarray签名

└─birthdayobject出生日期

└─countrystring居住国家

└─citystring居住城市

└─IdTypestring证件类型

└─IdNumstring证件号码

└─provincestring人员籍贯

└─homeAddressstring家庭地址

└─homePhonestring家庭电话

└─policitalStatusstring政治面貌

14

T/ZGCSA1.3—2022

名称类型描述

└─educationstring学历

└─maritalStatusint32婚姻状况

└─professionalstring专业

└─worktimeobject入职时间

4.1.11获取人员所在岗位列表

接口URL：

:8443/platform/services/rest/person/getPositions

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

personIdstring人员唯一标识

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataarray返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户Id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

15

T/ZGCSA1.3—2022

名称类型描述

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间

用逗号分隔

└─dutyTypestring职务类型

└─dutyLevelNamestring职级名称

└─dutyLevelint32职级

└─dutystring职务

└─typestring类型

└─orderedPathstringNocommentsfound.

4.2部门管理

4.2.1新建部门

接口URL：

:8443/platform/services/rest/department/createDepartment

请求方法：POST

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

departmentJsonstring部门JSON字符串

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

16

T/ZGCSA1.3—2022

名称类型描述

dataobject返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗

号分隔

└─aliasNamestring部门简称

└─deptGivenNamestring特定名称

└─enNamestring英文名称

└─gradeCodestring等级编码

└─divisionCodestring区域代码

└─deptAddressstring部门地址

└─deptOfficestring办公室

└─deptFaxstring传真号码

└─deptPhonestring电话号码

└─zipCodestring邮政编码

└─establishDateobject成立时间

17

T/ZGCSA1.3—2022

名称类型描述

└─bureauboolean是否委办局

4.2.2删除部门

接口URL：

:8443/platform/services/rest/department/deleteDepartment

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

departmentIdstringNocommentsfound.

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

databoolean返回的数据

4.2.3更新部门

接口URL：

:8443/platform/services/rest/department/saveDepartment

请求方法：POST

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

departmentstringNocommentsfound.

返回值说明

名称类型描述

successboolean操作是否成功

18

T/ZGCSA1.3—2022

名称类型描述

codeint32错误代码

msgstring错误信息

dataobject返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗号

分隔

└─aliasNamestring部门简称

└─deptGivenNamestring特定名称

└─enNamestring英文名称

└─gradeCodestring等级编码

└─divisionCodestring区域代码

└─deptAddressstring部门地址

└─deptOfficestring办公室

└─deptFaxstring传真号码

└─deptPhonestring电话号码

19

T/ZGCSA1.3—2022

名称类型描述

└─zipCodestring邮政编码

└─establishDateobject成立时间

└─bureauboolean是否委办局

4.2.4禁用部门

接口URL：

:8443/platform/services/rest/department/disableDepartment

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

departmentIdstring部门id

返回值说明

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

databoolean返回的数据

4.2.5获取部门下的所有人员(递归，包含部门下对应的人员)

接口URL：

:8443/platform/services/rest/department/getAllPersons

请求方法：GET

Content-Type：application/x-www-form-urlencoded;charset=utf-8

参数说明

名称类型描述

tenantIdstring租户id

departmentIdstring部门id

返回值说明

20

T/ZGCSA1.3—2022

名称类型描述

successboolean操作是否成功

codeint32错误代码

msgstring错误信息

dataarray返回的数据

└─idstring唯一标识

└─parentIdstring父节点ID

└─tenantIdstring租户id

└─createTimeobject创建时间

└─updateTimeobject更新时间

└─deletedboolean是否删除

└─disabledboolean是否禁用

└─descriptionstring描述

└─customIdstring自定义ID

└─dnstring域名称

└─namestring名称

└─orgTypestring节点类型

└─propertiesstring扩展属性（json格式）

└─tabIndexint32序号

└─guidPathstring由ID组成的父子关系列表，之间用逗号分隔

└─loginNamestring登录名称

└─passwordstring密码

└─avatorstring人员头像

└─officialint32编制名称

└─officialTypestring编制类型

└─dutystring职务

└─dutyLevelint32职级

└─dutyLevelNamestring职级名称

└─caidstringCA认证码