文档首页/ 需求管理 CodeArts Req/ API参考/ API/ IPD评审单管理/ 查询决策人/评审专家角色用户 - ListIpdReviewApproverOrReviewer
更新时间:2025-12-11 GMT+08:00
分享

查询决策人/评审专家角色用户 - ListIpdReviewApproverOrReviewer

功能介绍

查询决策人/评审专家角色用户列表

调用方法

请参见如何调用API

URI

GET /v1/ipdprojectservice/projects/{project_id}/user/role

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

user_type

String

参数解释:

用户类型。

约束限制:

传参非reviewer,默认为approver。

取值范围:

approver(审批人)

reviewer(评审专家)

默认取值:

approver

target_project_id

String

参数解释:

目标项目id,若有传值则替换project_id参数值,项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

review_id

String

参数解释:

评审单id,用于判断当前用户列表是否需要跨项目查询,评审单唯一标识,通过查询评审单列表接口获取,响应消息体中的id字段的值就是评审单ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

String

响应状态

message

String

响应错误信息

result

result object

决策人/评审专家角色用户列表

表4 result

参数

参数类型

描述

users

Array of users objects

用户列表

表5 users

参数

参数类型

描述

user_id

String

用户id

user_num_id

String

用户数字id

user_name

String

用户名称

domain_id

String

租户id

domain_name

String

租户名称

nick_name

String

昵称

role_id

String

角色id

role_name

String

角色名称

role_code

String

角色编码

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误描述,对error_code的补充解释。

取值范围:

不涉及。

请求示例

{{url}}/v1/ipdprojectservice/projects/b811b0bef58b479d9b5e4ab856b349ab/user/role?user_type=approver&review_id=&target_project_id=

响应示例

状态码:200

ok

{
  "status" : "success",
  "message" : null,
  "result" : {
    "users" : [ {
      "user_id" : "a360371833bf4c558f796fd707b44daf",
      "user_num_id" : null,
      "user_name" : "devcloud_devcloud_01",
      "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
      "domain_name" : null,
      "nick_name" : "张三丰1",
      "role_id" : "0c4370789ec246bb9f5480077e1119d5",
      "role_name" : "项目经理",
      "role_code" : "Project manager"
    }, {
      "user_id" : "a360371833bf4c558f796fd707b44daf",
      "user_num_id" : null,
      "user_name" : "devcloud_devcloud_01",
      "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
      "domain_name" : null,
      "nick_name" : "张三丰1",
      "role_id" : "0438be11ed284528ae79c8afd054ecf1",
      "role_name" : "项目管理员",
      "role_code" : "project_admin"
    } ]
  }
}

状态码:400

通用错误响应

{
  "error_code" : "PM.02174103",
  "error_msg" : "无操作权限"
}

状态码

状态码

描述

200

ok

400

通用错误响应

错误码

请参见错误码

相关文档