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
Коды ответов
Код | Статус | Описание |
---|---|---|
200 | Ok | Информация о релизе успешно получена |
400 | Bad Request | Некорректные параметры запроса |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Релиз или тег не найден |
500 | Internal Server Error | Внутренняя ошибка сервера |
Примечания:
- убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к репозиторию;
- метод возвращает информацию о релизе, но не сам файл артефакта.