Получить список релизов репозитория

GET /repos/{owner}/{repo}/releases

Описание

Этот метод позволяет получить список релизов в указанном репозитории с поддержкой пагинации и фильтрации по статусу (черновики, предварительные релизы).

Токен

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

Заголовки

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

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

Параметр	Обязательный	Описание
owner	Да	Владелец репозитория (логин или имя организации)
repo	Да	Название репозитория без расширения .git
per_page	Нет	Количество результатов на странице (максимум 30)
page	Нет	Номер страницы результатов

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

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

Тело запроса

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

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

curl -X GET "https://api.gitverse.ru/repos/myuser/myrepo/releases" \
  -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": 123,
    "tag_name": "v1.0.0",
    "name": "Release v1.0.0",
    "body": "Описание релиза",
    "draft": false,
    "prerelease": false,
    "is_authorized_only": false,
    "created_at": "2023-01-01T00:00:00Z",
    "published_at": "2023-01-01T00:00:00Z",
    "author": {
      "login": "user1",
      "name": "User One"
    },
    "assets": [
      {
        "id": 456,
        "name": "file.zip",
        "size": 1024,
        "download_count": 0,
        "browser_download_url": "https://api.gitverse.ru/repos/user1/repo/releases/123/assets/456/download"
      }
    ]
  }
]

Формат ответа: application/vnd.gitverse.object+json;version=1

Коды ответов

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

Примечания

• убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к репозиторию;
• возвращаемый список релизов может быть ограничен параметрами per_page и page.