5. GET /repos/{owner}/{repo}/branches — получить список веток

Описание

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

Параметры URL

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

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

Параметр	Тип	Обязательный	Описание	По умолчанию
page	integer	Нет	Номер страницы результатов	1
per_page	integer	Нет	Количество веток на странице (максимум — 50)	30
q	string	Нет	Фильтр: возвращает только ветки, имя которых содержит указанную подстроку	—

Тело запроса

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

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

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

Ответ (200 OK)

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

[
  {
    "name": "main",
    "commit": {
      "sha": "a1b2c3d4e5f6789012345678901234567890abcd",
      "created": "2025-10-20T14:30:00Z",
      "url": "https://api.gitverse.ru/repos/gitverse/example-repo/git/commits/a1b2c3d4e5f6789012345678901234567890abcd",
      "html_url": "https://gitverse.ru/gitverse/example-repo/commit/a1b2c3d4e5f6789012345678901234567890abcd"
    },
    "protected": false
  },
  {
    "name": "feature/auth",
    "commit": {
      "sha": "0987654321fedcba0987654321fedcba09876543",
      "created": "2025-10-22T09:15:00Z",
      "url": "https://api.gitverse.ru/repos/gitverse/example-repo/git/commits/0987654321fedcba0987654321fedcba09876543",
      "html_url": "https://gitverse.ru/gitverse/example-repo/commit/0987654321fedcba0987654321fedcba09876543"
    },
    "protected": true
  }
]

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

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

Поля каждой ветки

Поле	Тип	Описание
name	string	Имя ветки
commit	object	Информация о последнем коммите в ветке
protected	boolean	Является ли ветка защищенной

Подполе commit

Поле	Тип	Описание
sha	string	SHA-хеш коммита
created	string	Дата создания коммита (в формате RFC3339 / ISO 8601)
url	string	API-ссылка на коммит
html_url	string	Ссылка на коммит в веб-интерфейсе

Коды ответа

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