4. GET /orgs/{org}/packages/{package_type}/{package_name}/versions — получить версии пакета организации

Описание

Этот метод позволяет получить список версий пакета для указанной организации.

Параметры URL:

Параметр	Обязательный	Описание
org	Да	Имя организации
package_type	Да	Тип пакета
package_name	Да	Имя пакета
per_page	Нет	Количество результатов на странице
page	Нет	Номер страницы

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

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

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

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

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

curl -X GET "https://api.gitverse.ru/orgs/myorg/npm/my-package/versions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=latest" \
  -G \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=30"

Требования

Убедитесь, что API-токен указан корректно и обладает правами чтения на пакеты.

Ответ (200 OK):

Возвращает список версий пакета.

[
  {
    "id": 1,
    "name": "1.0.0",
    "description": "First stable release",
    "created_at": "2023-01-01T00:00:00Z",
    "html_url": "https://gitverse.ru/orgs/myorg/npm/my-package/versions/1",
    "package_html_url": "https://gitverse.ru/orgs/myorg/npm/my-package",
    "license": "MIT",
    "url": "https://api.gitverse.ru/orgs/myorg/packages/npm/my-package/versions/1",
    "metadata": {
      "package_type": "npm"
    }
  }
]

Поля ответа:

Поле	Тип	Описание
id	integer	Уникальный идентификатор версии
name	string	Название версии
description	string	Описание версии
created_at	string	Дата создания версии
html_url	string	URL веб-страницы версии
package_html_url	string	URL веб-страницы пакета
license	string	Лицензия
url	string	URL API версии
metadata	object	Метаданные версии

Поля метаданных metadata:

Поле	Тип	Описание
package_type	string	Тип пакета (npm, maven и др.)

Формат ответа: application/vnd.gitverse.object+json;version=latest

Коды ответов

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

Примечания:

• возвращаемый список версий может быть ограничен параметрами per_page и page.