Публичный APIСоавторы1. GET/repos/{owner}/{repo}/collaborators— получить список всех соавторов репозитория

1. GET/repos/{owner}/{repo}/collaborators — получить список всех соавторов репозитория

Описание

Возвращает список пользователей, имеющих доступ к репозиторию в качестве соавторов (collaborators), с указанием их прав.
Поддерживается пагинация и фильтрация по типу участия и уровню доступа.

Параметры URL

ПараметрТипОбязательныйОписание
ownerstringДаВладелец репозитория (пользователь или организация)
repostringДаНазвание репозитория

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

ПараметрТипОбязательныйОписаниеПо умолчанию
affiliationstringНетФильтр по типу участия:outside — внешние пользователи,direct — напрямую добавленные,all — всеall
permissionstringНетФильтр по уровню доступа: read, write, admin
pageintegerНетНомер страницы результатов1
per_pageintegerНетКоличество соавторов на странице (максимум — 50)30

Тело запроса

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

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

curl -X GET "https://api.gitverse.ru/repos/gitverse/example-repo/collaborators?affiliation=all&permission=write&page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

Ответ (200 OK)

Пример JSON-ответа:

[
  {
    "login": "alice",
    "id": 789,
    "avatar_url": "https://gitverse.ru/avatars/789.png",
    "html_url": "https://gitverse.ru/alice",
    "type": "User",
    "site_admin": false,
    "permissions": {
      "admin": false,
      "push": true,
      "pull": true
    }
  },
  {
    "login": "bob",
    "id": 456,
    "avatar_url": "https://gitverse.ru/avatars/456.png",
    "html_url": "https://gitverse.ru/bob",
    "type": "User",
    "site_admin": false,
    "permissions": {
      "admin": true,
      "push": true,
      "pull": true
    }
  }
]

Формат ответа

application/vnd.gitverse.object+json;version=1

Поля каждого соавтора

ПолеТипОписание
loginstringЛогин пользователя
idintegerУникальный идентификатор
avatar_urlstringСсылка на аватар
html_urlstringСсылка на профиль в веб-интерфейсе
typestringТип аккаунта (User или Organization)
site_adminbooleanЯвляется ли пользователь администратором платформы
permissionsobjectПрава доступа к репозиторию

Подполе permissions

ПолеТипОписание
adminbooleanПраво на управление репозиторием (настройки, соавторы и т.д.)
pushbooleanПраво на запись (push) в репозиторий
pullbooleanПраво на чтение (clone, pull)

💡 Уровни доступа в терминах GitVerse:

  • readpull: true, push: false, admin: false
  • writepull: true, push: true, admin: false
  • adminpull: true, push: true, admin: true

Коды ответа

КодСтатусОписание
200OKСписок соавторов успешно получен
400Bad RequestНекорректные параметры запроса
401UnauthorizedТокен отсутствует или недействителен
403ForbiddenНедостаточно прав для просмотра соавторов
404Not FoundРепозиторий не найден
500Internal Server ErrorВнутренняя ошибка сервера