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

GET /orgs/{org}/teams/{team_slug}/repos

Описание

Возвращает список репозиториев, к которым указанная команда имеет доступ и которые видны текущему авторизованному пользователю.

Команда определяется только внутри организации, указанной в параметре org. Команда с таким же slug в другой организации не используется.

Токен

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

Заголовки

Параметр	Обязательный	Описание
`accept`	Нет	Тип содержимого ответа. Рекомендуется установить `application/vnd.github+json`

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

Параметр	Тип	Обязательный	Описание
`org`	`string`	Да	Идентификатор организации
`team_slug`	`string`	Да	Slug команды внутри указанной организации

Параметры запроса

Параметр	Тип	Обязательный	Описание	По умолчанию
`page`	`integer`	Нет	Номер страницы	`1`
`per_page`	`integer`	Нет	Количество репозиториев на странице, максимум `100`	`30`

Параметры sort и direction не поддерживаются этим методом.

Тело запроса

Данный метод не требует тела запроса.

Пример запроса

curl -X GET "https://api.gitverse.ru/orgs/acme/teams/backend-team/repos?page=1&per_page=30" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.github+json"

Ответ (`200 OK`)

Ответ содержит массив объектов репозитория в GitHub-like формате.

[
  {
    "id": 545,
    "name": "platform-api",
    "full_name": "acme/platform-api",
    "private": true,
    "owner": {
      "login": "acme",
      "id": 49,
      "avatar_url": "https://api.gitverse.ru/avatars/avatar_hash",
      "html_url": "https://gitverse.ru/acme",
      "type": "Organization"
    },
    "html_url": "https://gitverse.ru/acme/platform-api",
    "description": "API сервиса платформы",
    "fork": false,
    "url": "https://api.gitverse.ru/repos/acme/platform-api",
    "clone_url": "https://gitverse.ru/acme/platform-api.git",
    "ssh_url": "git@gitverse.ru:acme/platform-api.git",
    "default_branch": "main",
    "visibility": "private",
    "permissions": {
      "pull": true,
      "push": true,
      "admin": false
    }
  }
]

Если у команды нет доступных репозиториев или ни один из них не виден текущему пользователю, метод возвращает пустой массив.

Поля ответа

Поле	Тип	Описание
`id`	integer	Уникальный числовой идентификатор репозитория
`name`	string	Название репозитория
`full_name`	string	Полное имя репозитория в формате `owner/repo`
`private`	boolean	Признак приватности репозитория
`owner`	object	Информация о владельце репозитория
`owner.login`	string	Логин владельца или название организации
`owner.id`	integer	Идентификатор владельца
`owner.avatar_url`	string	URL аватара владельца
`owner.html_url`	string	URL профиля владельца
`owner.type`	string	Тип владельца, например `User` или `Organization`
`html_url`	string	URL репозитория в GitVerse
`description`	string или null	Описание репозитория
`fork`	boolean	Является ли репозиторий форком
`url`	string	URL репозитория в Public API
`clone_url`	string	URL для клонирования по HTTPS
`ssh_url`	string	URL для клонирования по SSH
`default_branch`	string	Имя ветки по умолчанию
`visibility`	string	Видимость репозитория: `public`, `private` или `internal`
`permissions`	object	Права текущего пользователя на репозиторий
`permissions.pull`	boolean	Есть ли право на чтение
`permissions.push`	boolean	Есть ли право на запись
`permissions.admin`	boolean	Есть ли права администратора

Полное описание поддерживаемых полей объекта репозитория приведено в методе GET /orgs/{org}/repos.

Коды ответа

Код	Статус	Описание
`200`	OK	Список репозиториев команды успешно получен
`403`	Forbidden	Недостаточно прав на просмотр команды или ее репозиториев
`404`	Not Found	Организация или команда не найдена

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

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

{
  "error": {
    "code": "FORBIDDEN",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "Access denied",
    "status": 403
  }
}

Примечания

Команда ищется только внутри организации, указанной в параметре org.
В ответ включаются только репозитории, видимые текущему авторизованному пользователю.
Slug команды передается в параметре team_slug; числовой идентификатор или глобальный поиск команды не используются.

Проводник