Реестр пакетов
Описание работы функционала реестра пакетов доступно здесь.
Описание структур JSON-объектов
Пакет
| Поле | Тип | Описание |
|---|---|---|
id |
String | Уникальный ID пакета |
name |
String | Название пакета |
version |
String | Версия пакета |
groupId |
String | Идентификатор группы |
artifactId |
String | Идентификатор артефакта |
type |
String | Тип пакета. Возможные варианты: generic, maven, npm, pypi, nuget, composer, container, opm |
ownerUuid |
String | Уникальный ID владельца |
ownerType |
String | Тип владельца. Возможные варианты: PROJECT, COMPANY, GLOBAL |
Версия пакета
| Поле | Тип | Описание |
|---|---|---|
id |
String | Уникальный ID версии пакета |
baseVersion |
String | Базовая версия пакета |
version |
String | Версия пакета |
lowerVersion |
String | Версия пакета в нижнем регистре |
downloadCount |
Integer | Число скачиваний версии пакета |
languageVersion |
String | Версия языка программирования |
packageUploadType |
String | Способ загрузки пакета. Возможные варианты: TRANSPORT, MANUALLY, API |
packageFiles |
Object | Объект, содержащий информацию о прикрепленном файле. Ознакомиться с содержимым можно здесь |
internal |
Deprecated | Устаревший параметр. По умолчанию возвращает null |
Файл пакета
| Поле | Тип | Описание |
|---|---|---|
id |
String | Уникальный ID прикрепленного файла |
name |
String | Наименование файла |
size |
Integer | Размер файла в байтах |
hashMd5 |
String | Хэш в формате Md5 |
hashSHA1 |
String | Хэш в формате Sha1 |
hashSHA256 |
String | Хэш в формате Sha256 |
packageUploadType |
String | Способ загрузки файла. Возможные варианты: TRANSPORT, MANUALLY, API |
createdAt |
ZonedDateTime | Дата и время добавления файла |
Общие методы пакетов реестра
Получение всех пакетов
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package
Компании: GET /registry/company/{companyAlias}/package
Всего сервиса: GET /registry/package
Запрос возвращает список пакетов указанной сущности, есть возможность настройки количества отображаемых объектов на странице
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
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": "fc7f17df-aaaa-aaaa-aaaa-111042a265b8",
"ownerType": "PROJECT"
},
{
"id": "deb52e29-aaaa-aaaa-aaaa-737eac0eb8f7",
"name": "Example",
"version": "1.0.3",
"groupId": "example",
"artifactId": "example",
"type": "nuget",
"ownerUuid": "fc7f17df-aaaa-aaaa-aaaa-189042a111b8",
"ownerType": "PROJECT"
}
]
},
"page": {
"size": 10,
"totalElements": 2,
"totalPages": 1,
"number": 0
}
}
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Получение пакета по UUID
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/{packageUuid}
Компании: GET /registry/company/{companyAlias}/package/{packageUuid}
Всего сервиса: GET /registry/package/{packageUuid}
Запрос возвращает информацию о пакете указанной сущности
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
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": "fc7f17df-aaaa-aaaa-aaaa-189042a111b8",
"ownerType": "PROJECT"
}
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Получение списка версий пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/{packageUuid}/version-list
Компании: GET /registry/company/{companyAlias}/package/{packageUuid}/version-list
Всего сервиса: GET /registry/package/{packageUuid}/version-list
Запрос возвращает информацию о версиях пакета и их содержимом, есть возможность настройки количества отображаемых объектов на странице
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
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/project/{ownerAlias}/{projectAlias}/package/{packageUuid}/{packageVersion}
Компании: GET /registry/company/{companyAlias}/package/{packageUuid}/{packageVersion}
Всего сервиса: GET /registry/package/{packageUuid}/{packageVersion}
Запрос возвращает информацию о версии пакета и ее содержимом
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
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/project/{ownerAlias}/{projectAlias}/package/{packageUuid}/package-file
Компании: GET /registry/company/{companyAlias}/package/{packageUuid}/package-file
Всего сервиса: GET /registry/package/{packageUuid}/package-file
Запрос возвращает информацию о содержимом разных версий пакета, есть возможность настройки количества отображаемых объектов на странице
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
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 - Данные по запросу не найдены.
Удаление пакета проекта
Проекта: POST /registry/project/{ownerAlias}/{projectAlias}/package/{packageUuid}/delete
Компании: POST /registry/company/{companyAlias}/package/{packageUuid}/delete
Всего сервиса: POST /registry/package/{packageUuid}/delete
Метод удаляет пакет проекта
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageUuid |
String | Идентификатор пакета |
Responses
STATUS 200 - Пакет удален.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Удаление версии пакета проекта
Проекта: POST /registry/project/{ownerAlias}/{projectAlias}/package/{packageUuid}/{packageVersion}/delete
Компании: POST /registry/company/{companyAlias}/package/{packageUuid}/{packageVersion}/delete
Всего сервиса: POST /registry/package/{packageUuid}/{packageVersion}/delete
Метод удаляет версию пакета проекта
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageUuid |
String | Идентификатор пакета |
packageVersion |
String | Версия пакета |
Responses
STATUS 200 - Версия удалена.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Удаление содержимого версии пакета проекта
Проекта: POST /registry/project/{ownerAlias}/{projectAlias}/package/{packageUuid}/{packageVersion}/{fileUuid}/delete
Компании: POST /registry/company/{companyAlias}/package/{packageUuid}/{packageVersion}/{fileUuid}/delete
Всего сервиса: POST /registry/package/{packageUuid}/{packageVersion}/{fileUuid}/delete
Метод удаляет содержимое версии пакета проекта
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageUuid |
String | Идентификатор пакета |
packageVersion |
String | Версия пакета |
fileUuid |
String | Идентификатор файла |
Responses
STATUS 200 - Файл удален.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Частные методы пакетов реестра
Публикация Generic пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/generic/{packageName}/{packageVersion}/{fileName}
Компании: PUT /registry/company/{companyAlias}/package/generic/{packageName}/{packageVersion}/{fileName}
Всего сервиса: PUT /registry/package/generic/{packageName}/{packageVersion}/{fileName}
Запрос загружает прикрепленный файл в указанную версию пакета Generic. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание Generic пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/generic/{packageName}/{packageVersion}/{fileName}
Компании: GET /registry/company/{companyAlias}/package/generic/{packageName}/{packageVersion}/{fileName}
Всего сервиса: GET /registry/package/generic/{packageName}/{packageVersion}/{fileName}
Запрос возвращает файл пакета Generic
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация Maven пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/maven/{groupId}/{artifactId}/{version}/{fileName}
Компании: PUT /registry/company/{companyAlias}/package/maven/{groupId}/{artifactId}/{version}/{fileName}
Всего сервиса: PUT /registry/package/maven/{groupId}/{artifactId}/{version}/{fileName}
Запрос загружает прикрепленный файл в указанную версию пакета Maven. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
groupId |
String | Идентификатор группы |
artifactId |
String | Идентификатор артефакта |
version |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание Maven пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/maven/{packageUuid}/{packageVersion}/{fileUuid}/download
Компании: GET /registry/company/{companyAlias}/package/maven/{packageUuid}/{packageVersion}/{fileUuid}/download
Всего сервиса: GET /registry/package/maven/{packageUuid}/{packageVersion}/{fileUuid}/download
Запрос возвращает файл пакета Maven
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageUuid |
String | Идентификатор пакета |
packageVersion |
String | Версия пакета |
fileUuid |
String | Идентификатор файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация NPM пакета
В зависимости от наличия группы пакетов (scope) необходимо использовать один из перечисленных ниже методов:
-
Обновление пакета, для которого не указана группа (scope):
-
Проекта: PUT
/registry/project/{ownerAlias}/{projectAlias}/package/npm/{packageName}/{packageVersion}/{fileName} -
Компании: PUT
/registry/company/{companyAlias}/package/npm/{packageName}/{packageVersion}/{fileName} -
Всего сервиса: PUT
/registry/package/npm/{packageName}/{packageVersion}/{fileName}
-
-
Обновление пакета, для которого указана группа (scope):
-
Проекта: PUT
/registry/project/{ownerAlias}/{projectAlias}/package/npm/{packageName}/{packageScope}/{packageVersion}/{fileName} -
Компании: PUT
/registry/company/{companyAlias}/package/npm/{packageName}/{packageScope}/{packageVersion}/{fileName} -
Всего сервиса: PUT
/registry/package/npm/{packageName}/{packageScope}/{packageVersion}/{fileName}
-
Запрос загружает прикрепленный файл в указанную версию пакета NPM. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
paсkageScope |
String | Область видимости |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание NPM пакета
В зависимости от наличия группы пакетов (scope) необходимо использовать один из перечисленных ниже методов:
-
Получение пакета, для которого не указана группа (scope):
-
Проекта: GET
/registry/project/{ownerAlias}/{projectAlias}/package/npm/{packageName}/{packageVersion}/{fileName} -
Компании: GET
/registry/company/{companyAlias}/package/npm/{packageName}/{packageVersion}/{fileName} -
Всего сервиса: GET
/registry/package/npm/{packageName}/{packageVersion}/{fileName}
-
-
Получение пакета, для которого указана группа (scope):
-
Проекта: GET
/registry/project/{ownerAlias}/{projectAlias}/package/npm/{packageName}/{packageScope}/{packageVersion}/{fileName} -
Компании: GET
/registry/company/{companyAlias}/package/npm/{packageName}/{packageScope}/{packageVersion}/{fileName} -
Всего сервиса: GET
/registry/package/npm/{packageName}/{packageScope}/{packageVersion}/{fileName}
-
Запрос возвращает файл пакета NPM
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageScope |
String | Группа пакетов (scope) |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация PyPi пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/pypi/{packageName}/{packageVersion}/{fileName}
Компании: PUT /registry/company/{companyAlias}/package/pypi/{packageName}/{packageVersion}/{fileName}
Всего сервиса: PUT /registry/package/pypi/{packageName}/{packageVersion}/{fileName}
Запрос загружает прикрепленный файл в указанную версию пакета PyPi. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Пакет загружен.
STATUS 40S - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание PyPi пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/pypi/{packageName}/{packageVersion}/{fileName}
Компании: GET /registry/company/{companyAlias}/package/pypi/{packageName}/{packageVersion}/{fileName}
Всего сервиса: GET /registry/package/pypi/{packageName}/{packageVersion}/{fileName}
Запрос возвращает файл пакета PyPi
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация NuGet пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/nuget
Компании: PUT /registry/company/{companyAlias}/package/nuget
Всего сервиса: PUT /registry/package/nuget
Запрос загружает прикрепленный файл в указанную версию пакета NuGet. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание NuGet пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/nuget/{packageName}/{packageVersion}
Компании: GET /registry/company/{companyAlias}/package/nuget/{packageName}/{packageVersion}
Всего сервиса: GET /registry/package/nuget/{packageName}/{packageVersion}
Запрос возвращает файл пакета NuGet
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Создание Composer пакета по тегу
POST /project/{ownerAlias}/{projectAlias}/package/-/composer?tag={tagName}
Метод собирает Composer пакет из файлов репозитория по указанному тегу и размещает его в Реестре контейнеров и пакетов проекта.
Обратите внимание, данный запрос необходимо отправлять на URL, на котором расположен registry:
- для SaaS версии -
https://registry.gitflic.ru - для self-hosted
localhost:8080
Порт для self-hosted версии может отличаться
Пример:
https://registry.gitflic.ru/project/adminuser/test_project/package/-/composer?tag=1.2.3
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
tagName |
String | Название тега |
Авторизация для данного метода происходит с помощью Basic Auth. Для заголовка Authorization необходимо предоставить зашифрованные с помощью base64 учётные данные - Basic {login}:{transportToken}
Пример
Учетные данные adminuser@admin.local:qwerty123 в plain text будут иметь следующий вид в base64 в заголовке:
Authorization - Basic YWRtaW51c2VyQGFkbWluLmxvY2FsOnF3ZXJ0eTEyMw==
| Учетные данные | Тип | Описание |
|---|---|---|
login |
String | Псевдоним пользователя |
transportToken |
String | Транспортный токен |
С инструкцией по получению токена можно ознакомиться на странице.
Responses
STATUS 200 - Пакет создан и добавлен в Реестр контейнеров и пакетов.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация Composer пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/composer/{packageVersion}
Компании: PUT /registry/company/{companyAlias}/package/composer/{packageVersion}
Всего сервиса: PUT /registry/package/composer/{packageVersion}
Запрос загружает прикрепленный файл в указанную версию пакета Composer. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageVersion |
String | Версия пакета |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание Composer пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/composer/{groupId}/{artifactId}/{packageVersion}
Компании: GET /registry/company/{companyAlias}/package/composer/{groupId}/{artifactId}/{packageVersion}
Всего сервиса: GET /registry/package/composer/{groupId}/{artifactId}/{packageVersion}
Запрос возвращает файл пакета Composer
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
groupId |
String | Идентификатор группы |
artifactId |
String | Идентификатор артефакта |
packageVersion |
String | Версия пакета |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация OneScript пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/opm/{fileName}
Компании: PUT /registry/company/{companyAlias}/package/opm/{fileName}
Всего сервиса: PUT /registry/package/opm/{fileName}
Запрос загружает прикрепленный файл в указанную версию пакета OneScript. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
fileName |
String | Имя файла |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание OneScript пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/opm/{packageName}/{packageVersion}/{fileName}
Компании: GET /registry/company/{companyAlias}/package/opm/{packageName}/{packageVersion}/{fileName}
Всего сервиса: GET /registry/package/opm/{packageName}/{packageVersion}/{fileName}
Запрос возвращает файл пакета OneScript
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация Cran пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/cran/{languageVersion}/{fileName}
Компании: PUT /registry/company/{companyAlias}/package/cran/{languageVersion}/{fileName}
Всего сервиса: PUT /registry/package/cran/{languageVersion}/{fileName}
Запрос загружает прикрепленный файл в указанную версию пакета Cran. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
languageVersion |
String | Версия языка |
fileName |
String | Имя файла |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание Cran пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/cran/{fileName}?languageVersion={languageVersion}&platform={platform}
Компании: GET /registry/company/{companyAlias}/package/cran/{fileName}?languageVersion={languageVersion}&platform={platform}
Всего сервиса: GET /registry/package/cran/{fileName}?languageVersion={languageVersion}&platform={platform}
Запрос возвращает файл пакета Cran
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
fileName |
String | Имя файла |
languageVersion |
String | Версия языка |
platform |
String | Обязателен только для скачивания файлов в формате .tgz и .zip. Платформа, для которой создан пакет. Может принимать следующие значения: macosx, windows |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация Gem пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/rubygem
Компании: PUT /registry/company/{companyAlias}/package/rubygem
Всего сервиса: PUT /registry/package/rubygem
Запрос загружает прикрепленный файл в указанную версию пакета Gem. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание Gem пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/rubygem/{packageName}/{packageVersion}
Компании: GET /registry/company/{companyAlias}/package/rubygem/{packageName}/{packageVersion}
Всего сервиса: GET /registry/package/rubygem/{packageName}/{packageVersion}
Запрос возвращает файл пакета Gem
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация Cargo пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/cargo
Компании: PUT /registry/company/{companyAlias}/package/cargo
Всего сервиса: PUT /registry/package/cargo
Запрос загружает прикрепленный файл в указанную версию пакета Cargo. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание Cargo пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/cargo/{packageName}/{packageVersion}
Компании: GET /registry/company/{companyAlias}/package/cargo/{packageName}/{packageVersion}
Всего сервиса: GET /registry/package/cargo/{packageName}/{packageVersion}
Запрос возвращает файл пакета Cargo
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
packageName |
String | Имя пакета |
packageVersion |
String | Версия пакета |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Публикация Conda пакета
Проекта: PUT /registry/project/{ownerAlias}/{projectAlias}/package/conda/{fileName}?channel={channel}
Компании: PUT /registry/company/{companyAlias}/package/conda/{fileName}?channel={channel}
Всего сервиса: PUT /registry/package/conda/{fileName}?channel={channel}
Запрос загружает прикрепленный файл в указанную версию пакета Conda. С помощью данного метода можно создать новую версию пакета или пакет целиком, при условии указания не существующих данных.
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
fileName |
String | Имя файла |
fileName |
String | Необязательный запрос. Канал пакета |
Responses
STATUS 200 - Пакет загружен.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.
Скачивание Conda пакета
Проекта: GET /registry/project/{ownerAlias}/{projectAlias}/package/conda/{platform}/{fileName}
Компании: GET /registry/company/{companyAlias}/package/conda/{platform}/{fileName}
Всего сервиса: GET /registry/package/conda/{platform}/{fileName}
Запрос возвращает файл пакета Conda
| Переменная пути запроса | Тип | Описание |
|---|---|---|
ownerAlias |
String | Псевдоним владельца проекта |
projectAlias |
String | Псевдоним проекта |
companyAlias |
String | Псевдоним компании |
platform |
String | Платформа, для которой собран пакет |
fileName |
String | Имя файла |
Responses
STATUS 200 - Содержимое пакета получено.
STATUS 403 - Нет прав для доступа.
STATUS 404 - Данные по запросу не найдены.