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

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"

Ответ (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

Коды ответов

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

Примечания:

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