1. GET /users/{username}/packages/{package_type}/{package_name}/versions — получить версии пакета пользователя

Описание

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

Параметры URL:

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

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

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

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

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

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

curl -X GET "https://api.gitverse.ru/users/myusername/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",
    "license": "MIT",
    "created_at": "2023-01-01T00:00:00Z",
    "html_url": "https://gitverse.ru/users/myusername/npm/my-package/versions/1",
    "package_html_url": "https://gitverse.ru/users/myusername/npm/my-package",
    "url": "https://api.gitverse.ru/users/myusername/npm/my-package/versions/1",
    "metadata": {
      "package_type": "npm"
    }
  }
]

Поля ответа:

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

Поля metadata:

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

Формат ответа: 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.