1. GET /repos/{username}/{reponame}/releases
— получить список релизов репозитория
Описание
Возвращает список релизов в указанном репозитории с поддержкой пагинации и фильтрации по статусу (черновики, предварительные релизы). Только пользователи с правами чтения и записи в репозитории получают списки черновиков.
Параметры URL:
Параметр | Обязательный | Описание |
---|---|---|
username | Да | Имя владельца репозитория (пользователь или организация) |
reponame | Да | Название репозитория без расширения .git |
Параметры запроса:
Параметр | Обязательный | Описание |
---|---|---|
ApiKeyAuth | Да | Ключ API для авторизации. Формат: ApiKey <your_api_key> |
page | Нет | Номер страницы (начинается с 1) |
per_page | Нет | Количество результатов на странице (максимум 50) |
draft | Нет | Фильтр для черновиков (по умолчанию false ) |
pre_release | Нет | Фильтр для предварительных релизов (по умолчанию false ) |
Тело запроса:
Данный метод не требует тела запроса.
Пример запроса:
curl --location --request GET 'https://api.gitverse.ru/public/api/repos/hardqa_1/testo_repa/releases' \
--header 'accept: application/vnd.gitverse.object+json;version=1' \
--header 'Authorization: 84d2f6029336e1d899c53ea5813bd46e0d407f4e'
Ответ (200 OK
):
[
{
"id": 19,
"tag_name": "v3",
"target_commitish": "master",
"name": "release v3 API",
"body": "sdasdasdas",
"url": "https://api.gitverse.ru/public/api/repos/hardqa_1/testo_repa/releases/19",
"html_url": "https://gitverse.ru/hardqa_1/testo_repa/releases/tag/v3",
"tarball_url": "https://api.gitverse.ru/hardqa_1/testo_repa/archive/v3.tar.gz",
"zipball_url": "https://api.gitverse.ru/hardqa_1/testo_repa/archive/v3.zip",
"upload_url": "https://uploads.gitverse.ru/public/api/repos/hardqa_1/testo_repa/releases/19/assets",
"draft": false,
"prerelease": false,
"created_at": "2025-08-18T08:22:06Z",
"published_at": "2025-08-18T08:22:06Z",
"author": {
"id": 14,
"name": "",
"login": "hardqa_1",
"type": "User",
"bio": "",
"email": "hardqa_1@mail.ru",
"avatar_url": "https://gitverse.ru/avatars/d58095c0fe787f981dff5b6a41117aec",
"html_url": "https://gitverse.ru/hardqa_1",
"url": "https://api.gitverse.ruusers/hardqa_1",
"repos_url": "https://api.gitverse.ruusers/hardqa_1/repos",
"site_admin": false,
"location": null,
"followers": 0,
"following": 0,
"public_repos": 3,
"created_at": "2025-08-18T08:19:48Z",
"updated_at": "2025-08-18T08:57:48Z"
},
"assets": []
},
{
"id": 18,
"tag_name": "v2",
"target_commitish": "master",
"name": "release v2 API",
"body": "sdasdasdas",
"url": "https://api.gitverse.ru/public/api/repos/hardqa_1/testo_repa/releases/18",
"html_url": "https://api.gitverse.ru/hardqa_1/testo_repa/releases/tag/v2",
"tarball_url": "https://api.gitverse.ru/hardqa_1/testo_repa/archive/v2.tar.gz",
"zipball_url": "https://api.gitverse.ru/hardqa_1/testo_repa/archive/v2.zip",
"upload_url": "https://api.gitverse.ru/public/api/repos/hardqa_1/testo_repa/releases/18/assets",
"draft": false,
"prerelease": false,
"created_at": "2025-08-18T08:22:06Z",
"published_at": "2025-08-18T08:22:06Z",
"author": {
"id": 14,
"name": "",
"login": "hardqa_1",
"type": "User",
"bio": "",
"email": "hardqa_1@mail.ru",
"avatar_url": "https://api.gitverse.ru/avatars/d58095c0fe787f981dff5b6a41117aec",
"html_url": "https://gitverse.ru/hardqa_1",
"url": "https://gitverse.ru/hardqa_1",
"repos_url": "https://api.gitverse.ruusers/hardqa_1/repos",
"site_admin": false,
"location": null,
"followers": 0,
"following": 0,
"public_repos": 3,
"created_at": "2025-08-18T08:19:48Z",
"updated_at": "2025-08-18T08:57:48Z"
},
"assets": []
},
{
"id": 17,
"tag_name": "v1",
"target_commitish": "master",
"name": "releases v1 UI",
"body": "sdasdasdas",
"url": "https://api.gitverse.ru/public/api/repos/hardqa_1/testo_repa/releases/17",
"html_url": "https://api.gitverse.ru/hardqa_1/testo_repa/releases/tag/v1",
"tarball_url": "https://api.gitverse.ru/hardqa_1/testo_repa/archive/v1.tar.gz",
"zipball_url": "https://api.gitverse.ru/hardqa_1/testo_repa/archive/v1.zip",
"upload_url": "https://api.gitverse.ru/public/api/repos/hardqa_1/testo_repa/releases/17/assets",
"draft": false,
"prerelease": false,
"created_at": "2025-08-18T08:22:06Z",
"published_at": "2025-08-18T08:22:06Z",
"author": {
"id": 14,
"name": "",
"login": "hardqa_1",
"type": "User",
"bio": "",
"email": "hardqa_1@mail.ru",
"avatar_url": "https://api.gitverse.ru/avatars/d58095c0fe787f981dff5b6a41117aec",
"html_url": "https://gitverse.ru/hardqa_1",
"url": "https://api.gitverse.ruusers/hardqa_1",
"repos_url": "https://api.gitverse.ruusers/hardqa_1/repos",
"site_admin": false,
"location": null,
"followers": 0,
"following": 0,
"public_repos": 3,
"created_at": "2025-08-18T08:19:48Z",
"updated_at": "2025-08-18T08:57:48Z"
},
"assets": [
{
"id": 17,
"name": "file_jpg.jpg",
"size": 120750,
"download_count": 1,
"created_at": "2025-08-18T08:31:24Z",
"uuid": "b554efb0-b617-44e4-b2c1-5893871edea8",
"browser_download_url": "https://api.gitverse.ru/public/api/attachments/b554efb0-b617-44e4-b2c1-5893871edea8"
},
{
"id": 16,
"name": "file_png.png",
"size": 49987,
"download_count": 0,
"created_at": "2025-08-18T08:31:24Z",
"uuid": "cfd40589-bd8c-4b24-a6f0-000de0b7d284",
"browser_download_url": "https://api.gitverse.ru/public/api/attachments/cfd40589-bd8c-4b24-a6f0-000de0b7d284"
}
]
}
]
Формат ответа: application/vnd.gitverse.object+json;version=1
Коды ответов
Код | Статус | Описание |
---|---|---|
200 | Ok | Запрос выполнен успешно, список релизов получен |
400 | Bad Request | Некорректные параметры запроса |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Указанный репозиторий не найден |
500 | Internal Server Error | Внутренняя ошибка сервера |
Примечания:
- Убедитесь, что вы используете правильный ключ API с необходимыми правами доступа к репозиторию.
- Параметры фильтрации позволяют уточнить результаты поиска релизов.
- Только пользователи с правами чтения и записи в репозитории видят черновики.