8. GET /repos/{owner}/{repo}/releases/{release_id}/assets — получить список ассетов релиза

Описание

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

Параметры URL:

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

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

ПараметрОбязательныйОписание
pageНетНомер страницы (начиная с 1)
per_pageНетКоличество результатов на странице (максимум 50)

Тело запроса:

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

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

curl -X GET "https://api.gitverse.ru/repos/myuser/myrepo/releases/123/assets" \
  -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": 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

Коды ответов

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

Примечания:

  • убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к репозиторию;
  • возвращаемый список ассетов может быть ограничен параметрами page и per_page;
  • скачивание ассета по ссылке browser_download_url (домен api.gitverse.ru) поддерживает возобновление прерванных загрузок (Range Requests, заголовки Accept-Ranges и Content-Length).