Скачать артефакт как ZIP-архив

GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip

Описание

Этот метод перенаправляет на прямую ссылку, где можно скачать артефакт в виде ZIP-архива. Артефакты могут скачивать только те пользователи, у которых есть как минимум доступ на чтение указанного репозитория.

Токен

Требуется токен с правами на Чтение для Репозитория.

Заголовки

Параметр	Обязательный	Описание
accept	Нет	Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest

Параметры пути

Параметр	Обязательный	Описание
owner	Да	Владелец репозитория (логин или название организации)
repo	Да	Название репозитория
artifact_id	Да	Идентификатор артефакта

Параметры запроса

Данный метод не требует параметров запроса.

Тело запроса

Данный метод не требует тела запроса.

Пример запроса

curl -X GET "https://api.gitverse.ru/repos/myuser/myrepo/actions/artifacts/123/zip" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

Ответ (302 Found)

Ответ содержит заголовок Location с URL для скачивания ZIP-архива артефакта.

Коды ответов

Код	Статус	Описание
302	Found	Перенаправление на URL для скачивания ZIP-архива
400	Bad Request	Некорректный формат данных
401	Unauthorized	Необходима авторизация
403	Forbidden	Доступ запрещен
404	Not Found	Артефакт не найден
429	Too Many Requests	Превышен лимит запросов
500	Internal Server Error	Внутренняя ошибка сервера

Пример тела ошибки

При ответе 400 тело ответа имеет следующий вид:

{
  "error": {
    "code": "BAD_REQUEST",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "The request format is invalid",
    "status": 400
  }
}

Примечания

• убедитесь, что токен API указан корректно и обладает необходимыми правами для доступа к репозиторию;
• метод возвращает перенаправление (302 Found) на URL для скачивания архива;
• можно скачивать только те артефакты, которые были сохранены с помощью actions/upload-artifact@v4;
• скачивание артефакта по ссылке archive_download_url (домен api.gitverse.ru) поддерживает возобновление прерванных загрузок (Range Requests, заголовки Accept-Ranges и Content-Length).