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

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

Beta

Описание

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

Параметры 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,
    "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Репозиторий не найден
500Internal Server ErrorВнутренняя ошибка сервера

Примечания:

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