| GitVerse

6. `GET /repos/{owner}/{repo}/releases/tags/{tag}` — получить информацию о релизе по тегу

Описание

Этот метод позволяет получить информацию о конкретном релизе, используя его Git-тег. Просматривать релиз могут только те пользователи, у которых есть как минимум доступ на чтение указанного репозитория. Если тег не существует или не имеет связанного с ним релиза, возвращается ошибка 404.

Параметры URL:

Параметр	Обязательный	Описание
`owner`	Да	Владелец репозитория (логин или имя организации)
`repo`	Да	Название репозитория без расширения .git
`tag`	Да	Имя тега релиза (например, ‘v1.0.0’)

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

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

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

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

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

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

Ответ (`200 OK`):

Ответ содержит информацию о релизе.

{
  "id": 123,
  "node_id": "MDc6UmVsZWFzZTEyMw==",
  "tag_name": "v1.0.0",
  "target_commitish": "main",
  "name": "Version 1.0.0",
  "body": "Release notes for version 1.0.0",
  "draft": false,
  "prerelease": false,
  "created_at": "2023-01-01T00:00:00Z",
  "published_at": "2023-01-01T00:00:00Z",
  "author": {
    "login": "myuser",
    "id": 12345,
    "avatar_url": "https://api.gitverse.ru/avatar/12345",
    "html_url": "https://api.gitverse.ru/users/myuser"
  },
  "assets": [
    {
      "id": 456,
      "node_id": "MDc6QXNzZXN0NDU2",
      "name": "package.zip",
      "size": 1024,
      "download_count": 0,
      "created_at": "2023-01-01T00:00:00Z",
      "browser_download_url": "https://api.gitverse.ru/repos/myuser/myrepo/releases/assets/456"
    }
  ]
}

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

Коды ответов

Код	Статус	Описание
`200`	Ok	Информация о релизе успешно получена
`400`	Bad Request	Некорректные параметры запроса
`403`	Forbidden	Доступ запрещен
`404`	Not Found	Релиз или тег не найден
`500`	Internal Server Error	Внутренняя ошибка сервера

Примечания:

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

5. PATCH /repos/{owner}/{repo}/releases/{release_id} — редактировать информацию о релизе 7. DELETE /repos/{owner}/{repo}/releases/tags/{tag} — удалить релиз по тегу

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