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

Описание

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

Параметры URL:

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

Коды ответов

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

Примечания:

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