Получить список участников команды

GET /orgs/{org}/teams/{team}/members

Описание

Возвращает список всех участников указанной команды в организации. Метод полезен для аудита доступов, проверки состава команды и интеграций с системами управления идентификацией (IAM).

Токен

Требуется токен с правами на Чтение для Организации.

Заголовки

Параметр	Обязательный	Описание
accept	Нет	Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest

Параметры пути

Параметр	Обязательный	Описание
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.

Коды ответов

Код	Статус	Описание
204	No Content	Пользователь является участником
302	Found	Пользователь не является участником
400	Bad Request	Некорректные параметры запроса
401	Unauthorized	Неавторизованный доступ
403	Forbidden	Доступ запрещен
404	Not Found	Не найдено

Пример тела ошибки

При ответе 400 тело ответа имеет следующий вид:

{
  "error": {
    "code": "BAD_REQUEST",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "The request format is invalid",
    "status": 400
  }
}