3. GET /repos/{owner}/{repo}/releases/{release_id} — получить информацию о релизе

Описание

Этот метод позволяет получить информацию о конкретном релизе по его идентификатору.

Параметры URL:

ПараметрОбязательныйОписание
ownerДаВладелец репозитория (логин или имя организации)
repoДаНазвание репозитория без расширения .git
release_idДаИдентификатор релиза

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

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

Тело запроса:

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

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

curl -X GET "https://api.gitverse.ru/repos/myuser/myrepo/releases/123" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

Ответ (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 указан корректно и обладает необходимыми правами для доступа к репозиторию;
  • релиз должен существовать в репозитории.