查询决策人/评审专家角色用户 - ListIpdReviewApproverOrReviewer
功能介绍
查询决策人/评审专家角色用户列表
调用方法
请参见如何调用API。
URI
GET /v1/ipdprojectservice/projects/{project_id}/user/role
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
响应状态 |
|
message |
String |
响应错误信息 |
|
result |
result object |
决策人/评审专家角色用户列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
通用错误响应 |
错误码
请参见错误码。