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