Методы пакетов уровня сервиса
Для работы данных методов необходимы права администратора сервиса
Метод получения всех пакетов сервиса
GET /registry/package
Запрос возвращает список пакетов сервиса, есть возможность настройки количества отображаемых объектов на странице
Responses
STATUS 200 пример JSON:
Пример ответа
{
"_embedded": {
"simplePackageInfoModelList": [
{
"id": "23920af6-aaaa-aaaa-aaaa-396811188f65",
"name": "Package",
"version": "1.0.0",
"groupId": "group",
"artifactId": "artefact](.. "type": "generic",
"ownerUuid": "",
"ownerType": "GLOBAL"
},
{
"id": "deb52e29-aaaa-aaaa-aaaa-737eac0eb8f7",
"name": "Example",
"version": "1.0.3",
"groupId": "example",
"artifactId": "example",
"type": "nuget",
"ownerUuid": "",
"ownerType": "GLOBAL"
}
]
},
"page": {
"size": 10,
"totalElements": 2,
"totalPages": 1,
"number": 0
}
}
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения пакета сервиса по UUID
GET /registry/package/{packageUuid}
Запрос возвращает информацию о пакете сервиса
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageUuid |
String | Идентификатор пакета |
Responses
STATUS 200 пример JSON:
Пример ответа
{
"id": "7eeda8b0-aaaa-aaaa-aaaa-bd1fed06bf95",
"name": "Package",
"version": "1.0.1",
"groupId": "Package",
"artifactId": "Package",
"type": "generic",
"ownerUuid": "",
"ownerType": "GLOBAL"
}
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения списка версий пакета сервиса
GET /registry/package/{packageUuid}/version-list
Запрос возвращает информацию о версиях пакета и их содержимом, есть возможность настройки количества отображаемых объектов на странице
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageUuid |
String | Идентификатор пакета |
Responses
STATUS 200 пример JSON:
Пример ответа
{
"_embedded": {
"simplePackageVersionModelList": [
{
"id": "fb97db0e-aaaa-aaaa-aaaa-9a95f4f36e9a",
"baseVersion": "1.2.3",
"version": "1.2.3",
"lowerVersion": "1.2.3",
"downloadCount": 12,
"languageVersion": null,
"packageUploadType": "MANUALLY",
"packageFiles": [
{
"id": "6dd3bea5-aaaa-aaaa-aaaa-c49a0025279c",
"name": "gitflic-helper",
"size": 631382,
"hashMd5": "518e87b56adeaaaaaaaa9b6575399e1e",
"hashSHA1": "d06a0844f92daaaaaaaaaaaaaaaa275c448ce0e1",
"hashSHA256": "ad98cee24564aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac56a27d22ac1",
"packageUploadType": "MANUALLY",
"createdAt": "2024-08-01T06:57:07.150295"
}
],
"internal": null
},
{
"id": "800cad33-aaaa-aaaa-aaaa-8ba5864b4914",
"baseVersion": "2.4.7",
"version": "2.4.7",
"lowerVersion": "2.4.7",
"downloadCount": 31,
"languageVersion": null,
"packageUploadType": "API",
"packageFiles": [
{
"id": "684068a6-aaaa-aaaa-aaaa-bebea0e2b46a",
"name": "gitflic.ssh",
"size": 4325,
"hashMd5": "d41d8cd98f00aaaaaaaa0998ecf8427e",
"hashSHA1": "da39a3ee5e6baaaaaaaaaaaaaaaa1890afd80709",
"hashSHA256": "e3b0c44298fcaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa991b7852b855",
"packageUploadType": "API",
"createdAt": "2024-07-31T14:02:49.393146"
}
],
"internal": null
}
]
},
"page": {
"size": 10,
"totalElements": 2,
"totalPages": 1,
"number": 0
}
}
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения версии пакета сервиса
GET /registry/package/{packageUuid}/{packageVersion}
Запрос возвращает информацию о версии пакета и ее содержимом
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageUuid |
String | Идентификатор пакета |
packageVersion |
String | Версия пакета |
Responses
STATUS 200 пример JSON:
Пример ответа
{
"id": "fb97db0e-aaaa-aaaa-aaaa-9a95f4f36e9a",
"baseVersion": "1.2.3",
"version": "1.2.3",
"lowerVersion": "1.2.3",
"downloadCount": 12,
"languageVersion": null,
"packageUploadType": "MANUALLY",
"packageFiles": [
{
"id": "6dd3bea5-aaaa-aaaa-aaaa-c49a0025279c",
"name": "gitflic-helper",
"size": 631382,
"hashMd5": "518e87b56adeaaaaaaaa9b6575399e1e",
"hashSHA1": "d06a0844f92daaaaaaaaaaaaaaaa275c448ce0e1",
"hashSHA256": "ad98cee24564aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac56a27d22ac1",
"packageUploadType": "MANUALLY",
"createdAt": "2024-08-01T06:57:07.150295"
}
],
"internal": null
}
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения информации о содержимом пакета сервиса
GET /registry/package/{packageUuid}/package-file
Запрос возвращает информацию о содержимом разных версий пакета, есть возможность настройки количества отображаемых объектов на странице
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageUuid |
String | Идентификатор пакета |
Responses
STATUS 200 пример JSON:
Пример ответа
{
"_embedded": {
"simplePackageFileModelList": [
{
"id": "6dd3bea5-aaaa-aaaa-aaaa-c49a0025279c",
"name": "gitflic-helper",
"size": 631382,
"hashMd5": "518e87b56adeaaaaaaaa9b6575399e1e",
"hashSHA1": "d06a0844f92daaaaaaaaaaaaaaaa275c448ce0e1",
"hashSHA256": "ad98cee24564aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac56a27d22ac1",
"packageUploadType": "MANUALLY",
"createdAt": "2024-08-01T06:57:07.150295"
},
{
"id": "684068a6-aaaa-aaaa-aaaa-bebea0e2b46a",
"name": "gitflic.ssh",
"size": 4325,
"hashMd5": "d41d8cd98f00aaaaaaaa0998ecf8427e",
"hashSHA1": "da39a3ee5e6baaaaaaaaaaaaaaaa1890afd80709",
"hashSHA256": "e3b0c44298fcaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa991b7852b855",
"packageUploadType": "API",
"createdAt": "2024-07-31T14:02:49.393146"
}
]
},
"page": {
"size": 10,
"totalElements": 2,
"totalPages": 1,
"number": 0
}
}
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения содержимого пакета generic
GET /registry/package/generic/{packageName}/{packageVersion}/{fileName}
Запрос возвращает файл пакета generic
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения содержимого пакета PyPI
GET /registry/package/pypi/{packageName}/{packageVersion}/{fileName}
Запрос возвращает файл пакета PyPi
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения содержимого пакета Maven
GET /registry/package/maven/{packageUuid}/{packageVersion}/{fileUuid}/download
Запрос возвращает файл пакета Maven
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageUuid |
String | Идентификатор пакета |
packageVersion |
String | Версия пакета |
fileUuid |
String | Идентификатор файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Метод получения содержимого пакета npm
В зависимости от наличия группы пакетов (scope) необходимо использовать один из перечисленных ниже методов:
Получение пакета, для которого не указана группа (scope):
GET /registry/package/npm/{packageName}/{packageVersion}/{fileName}
Получение пакета, для которого указана группа (scope):
GET /registry/package/npm/{packageName}/{packageScope}/{packageVersion}/{fileName}
Запрос возвращает файл пакета npm
| Переменная пути запроса | Тип | Описание |
|---|---|---|
packageName |
String | Имя пакета |
packageScope |
String | Группа пакетов (scope) |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.