🎉 Версия 20.2.0. Что новенького? →
Публичный APIРелизы1. GET /repos/{username}/{reponame}/releases — получить список релизов репозитория

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

Коды ответов

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

Примечания:

  • Убедитесь, что вы используете правильный ключ API с необходимыми правами доступа к репозиторию.
  • Параметры фильтрации позволяют уточнить результаты поиска релизов.
  • Только пользователи с правами чтения и записи в репозитории видят черновики.
Релизы2. POST /repos/{username}/{reponame}/releases — создать новый релиз