2. GET /orgs/{org}/teams/{team}/members
— получить список участников команды
Beta
Описание
Возвращает список всех участников указанной команды в организации.
Метод полезен для аудита доступов, проверки состава команды и интеграций с системами управления идентификацией (IAM).
Параметры URL
Параметр | Обязательный | Описание |
---|---|---|
org | Да | Название организации |
team | Да | Слаг (slug) команды (обычно имя в нижнем регистре, например frontend-team ) |
Параметры запроса
Параметр | Тип | Обязательный | Описание | По умолчанию |
---|---|---|---|---|
page | integer | Нет | Номер страницы пагинации | 1 |
per_page | integer | Нет | Количество участников на странице (макс. 100) | 30 |
Тело запроса
Данный метод не требует тела запроса.
Пример запроса
curl -X GET "https://api.gitverse.ru/orgs/my-organization/teams/backend-team/members" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1" \
-G \
--data-urlencode "page=1" \
--data-urlencode "per_page=30"
Ответ (200 OK
)
[
{
"id": 101,
"login": "alice",
"full_name": "Alice Johnson",
"email": "alice@example.com",
"avatar_url": "https://gitverse.ru/avatars/alice.jpg",
"html_url": "https://gitverse.ru/alice",
"type": "User"
},
{
"id": 102,
"login": "bob",
"full_name": "Bob Smith",
"email": "bob@example.com",
"avatar_url": "https://gitverse.ru/avatars/bob.jpg",
"html_url": "https://gitverse.ru/bob",
"type": "User"
}
]
Формат ответа:
application/vnd.gitverse.object+json;version=1
Поля ответа
Поле | Тип | Описание |
---|---|---|
id | number | Уникальный идентификатор пользователя |
login | string | Логин пользователя (никнейм) |
full_name | string | null | Полное имя пользователя (может быть null ) |
email | string | null | Email пользователя (если доступен и видим) |
avatar_url | string | Ссылка на аватар пользователя |
html_url | string | Ссылка на профиль пользователя в GitVerse |
type | string | Тип субъекта: User , Bot , Organization |
⚠️ Важно:
Команда должна быть видимой для авторизованного пользователя. В противном случае вернется403 Forbidden
.