组和项目成员API
有效的访问级别
中定义了访问级别Gitlab:访问
模块。目前,这些水平是公认的:
10 => Guest权限20 => Reporter访问30 =>开发者权限40 =>主访问50 =>所有者访问#只对组有效
列出组或项目的所有成员
获取经过身份验证的用户可查看的组或项目成员列表。
得到/团体/:id /成员/项目/:id /成员
属性 | 类型 | 要求 | 描述 |
---|---|---|---|
id |
整数或字符串 | 是的 | ID或项目或组的url编码路径被认证的用户所有 |
查询 |
字符串 | 没有 | 用于搜索成员的查询字符串 |
旋度——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/groups/:id/members旋度——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/projects/:id/members
示例响应:
[{“id”:1,“用户名”:“raymond_smith”,“名称”:“雷蒙德·史密斯”,“状态”:“活跃”,“created_at”:“2012 - 10 - 22 - t14:13:35z”,“access_level”:30.},{“id”:2,“用户名”:“john_doe”,“名称”:“John Doe”,“状态”:“活跃”,“created_at”:“2012 - 10 - 22 - t14:13:35z”,“access_level”:30.}]
找一个小组或项目的成员
获取组或项目的成员。
得到/团体/:/ id /成员:user_id/项目/:/ id /成员:user_id
属性 | 类型 | 要求 | 描述 |
---|---|---|---|
id |
整数或字符串 | 是的 | ID或项目或组的url编码路径被认证的用户所有 |
user_id |
整数 | 是的 | 成员的用户ID |
旋度——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/groups/:id/members/:user_id旋度——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/projects/:id/members/:user_id
示例响应:
{“id”:1,“用户名”:“raymond_smith”,“名称”:“雷蒙德·史密斯”,“状态”:“活跃”,“created_at”:“2012 - 10 - 22 - t14:13:35z”,“access_level”:30.,“expires_at”:零}
向组或项目添加成员
将成员添加到组或项目中。
POST /团体/:id /成员POST /项目/:id /成员
属性 | 类型 | 要求 | 描述 |
---|---|---|---|
id |
整数或字符串 | 是的 | ID或项目或组的url编码路径被认证的用户所有 |
user_id |
整数 | 是的 | 新成员的用户ID |
access_level |
整数 | 是的 | 有效的访问级别 |
expires_at |
字符串 | 没有 | 日期字符串,格式为YEAR-MONTH-DAY |
旋度——请求帖子——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”——数据“user_id = 1 &access_level = 30”https://gitlab.example.com/api/v4/groups/:id/members旋度——请求帖子——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”——数据“user_id = 1 &access_level = 30”https://gitlab.example.com/api/v4/projects/:id/members
示例响应:
{“id”:1,“用户名”:“raymond_smith”,“名称”:“雷蒙德·史密斯”,“状态”:“活跃”,“created_at”:“2012 - 10 - 22 - t14:13:35z”,“access_level”:30.}
编辑组或项目的成员
更新组或项目的成员。
/团体/:/ id /成员:user_id/ /项目/:id /成员:user_id
属性 | 类型 | 要求 | 描述 |
---|---|---|---|
id |
整数或字符串 | 是的 | ID或项目或组的url编码路径被认证的用户所有 |
user_id |
整数 | 是的 | 成员的用户ID |
access_level |
整数 | 是的 | 有效的访问级别 |
expires_at |
字符串 | 没有 | 日期字符串,格式为YEAR-MONTH-DAY |
旋度——请求把——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/groups/:id/members/:user_id?access_level=40旋度——请求把——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/projects/:id/members/:user_id?access_level=40
示例响应:
{“id”:1,“用户名”:“raymond_smith”,“名称”:“雷蒙德·史密斯”,“状态”:“活跃”,“created_at”:“2012 - 10 - 22 - t14:13:35z”,“access_level”:40}
从组或项目中删除成员
从组或项目中删除用户。
删除/团体/:/ id /成员:user_id删除/项目/:/ id /成员:user_id
属性 | 类型 | 要求 | 描述 |
---|---|---|---|
id |
整数或字符串 | 是的 | ID或项目或组的url编码路径被认证的用户所有 |
user_id |
整数 | 是的 | 成员的用户ID |
旋度——请求删除——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/groups/:id/members/:user_id旋度——请求删除——头“PRIVATE-TOKEN: 9 koxpg98eahejpvbs5tk”https://gitlab.example.com/api/v4/projects/:id/members/:user_id