群组和项目访问请求 API (BASIC ALL)
有效访问级别
访问级别定义于 Gitlab::Access
模块,且识别以下级别:
- No access(
0
) - Minimal access(
5
)(引入于极狐GitLab 13.5。) - Guest(
10
) - Reporter(
20
) - Developer(
30
) - Maintainer(
40
) - Owner(
50
)。对 14.9 及更高版本中的项目有效。
为群组或项目列出访问请求
获取经过身份验证的用户可见的访问请求列表。
GET /groups/:id/access_requests
GET /projects/:id/access_requests
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 授权用户拥有的 ID 或 URL 编码的项目路径 |
请求示例:
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests"
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests"
响应示例:
[
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"created_at": "2012-10-22T14:13:35Z",
"requested_at": "2012-10-22T14:13:35Z"
},
{
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"created_at": "2012-10-22T14:13:35Z",
"requested_at": "2012-10-22T14:13:35Z"
}
]
请求访问群组或项目
经过身份验证的用户请求访问群组或项目。
POST /groups/:id/access_requests
POST /projects/:id/access_requests
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | ID 或 URL 编码的群组或项目路径 |
请求示例:
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests"
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"created_at": "2012-10-22T14:13:35Z",
"requested_at": "2012-10-22T14:13:35Z"
}
批准访问请求
批准特定用户的访问请求。
PUT /groups/:id/access_requests/:user_id/approve
PUT /projects/:id/access_requests/:user_id/approve
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 授权用户拥有的 ID 或 URL 编码的项目路径 |
user_id
| integer | yes | 访问请求者的用户 ID |
access_level
| integer | no | 有效的访问级别(默认为 30 ,开发者角色)
|
请求示例:
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests/:user_id/approve?access_level=20"
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests/:user_id/approve?access_level=20"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"created_at": "2012-10-22T14:13:35Z",
"access_level": 20
}
拒绝访问请求
拒绝特定用户的访问请求。
DELETE /groups/:id/access_requests/:user_id
DELETE /projects/:id/access_requests/:user_id
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 授权用户拥有的 ID 或 URL 编码的项目路径 |
user_id
| integer | yes | 访问请求者的用户 ID |
请求示例:
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests/:user_id"
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests/:user_id"