查询人员信息 - getUserInfos

X-Auth-Token

是

String

参数解释：

IAM用户的token。

通过调用IAM服务获取用户Token接口获取（即响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Application-Id

是

String

参数解释：

应用ID。

您可以在应用设计态的“应用中心 > 应用发布”页面获取，详情请参见应用发布。

约束限制：

不涉及。

取值范围：

由英文字母和数字组成，且长度为32个字符。

默认取值：

不涉及。

X-Tenant-Id

是

String

参数解释：

数据建模引擎运行态租户ID。

您可以从访问流程引擎编排服务的浏览器地址栏中获取。

流程编排服务地址：http://{承载流程编排服务的服务器域名或IP地址}:{流程编排服务的端口号}/{流程编排服务文根}/index.html#/processApplicationForm?tenantId={数据建模引擎运行态租户ID}&applicationId={应用ID}

例如tenantId=-1，表示数据建模引擎运行态默认租户“basicTenant”的租户ID为-1。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-User-Id

是

String

参数解释：

请求当前接口时上下文中的用户ID，即OrgID的用户ID。

通过调用OrgID服务的获取用户信息接口获取。

约束限制：

仅基础版数据建模引擎-流程引擎需要配置此参数。

取值范围：

不涉及。

默认取值：

不涉及。

userCn

是

String

参数解释：

用户中文名，用于指定需要查询的用户名称。支持模糊匹配，传入部分名称即可检索包含该字符串的所有用户。

约束限制：

不涉及。

取值范围：

最大长度100字符。

默认取值：

不涉及。

code

Integer

参数解释：

接口返回码，标识接口调用的执行结果。

取值范围：

• 200：成功。

• 非200：失败，具体错误码请参见错误码。

data

Array of UserInfoVo objects

参数解释：

接口响应数据，包含查询到的用户信息列表。如未找到匹配用户，返回空数组[]。

取值范围：

不涉及。

orderID

String

参数解释：

请求跟踪流水号，用于唯一标识本次接口请求，便于问题排查和链路追踪。

遇到问题时，请提供此ID联系技术支持。

取值范围：

不涉及。

accountStatus

String

参数解释：

账号状态，标识用户账号的当前可用状态。调用方需根据此字段过滤不可用用户。

取值范围：

• 1：正常，账号可用。

• 0：账号状态异常，账号不可用（如已停用、已锁定等）。

ucn

String

参数解释：

用户名中文名（User Chinese Name），用于展示用户的可读名称。与查询参数“userCn”匹配时返回此字段值。

取值范围：

不涉及。

uid

String

参数解释：

用户标识（User ID），通常与“ucn”值一致，用于系统内部用户标识。

取值范围：

不涉及。

uuid

String

参数解释：

用户唯一标识（Universally Unique Identifier），用于在分布式系统中唯一标识用户。此字段为启动流程时“participant”区块配置参与者的关键字段。

取值范围：

不涉及。

account

String

参数解释：

账号名，用于用户登录系统的账户标识。通常与“ucn”值一致。

取值范围：

不涉及。

error_code

String

错误码。

error_msg

String

错误描述。

result

String

结果。

trace_id

String

追踪ID。

200

OK

400

Bad Request