Документ отображается в упрощённом режиме просмотра — часть интерактивных элементов может работать ограниченно.

Scap.Service (1.0)

Download OpenAPI specification:Download

Authentication

Авторизация пользователя в системе SCAP.

Получение токена авторизации из сервиса лицензирования через SCAP.

Authorizations:
Bearer
path Parameters
username
required
string
query Parameters
tenantName
string
Request Body schema:
required
password
required
string non-empty

Значение пароля.

Responses

Request samples

Content type
{
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "token": "string",
  • "role": "string",
  • "login": "string",
  • "tenantInfo": {
    }
}

Core

Сгенерировать историю изменений SCAP.

Authorizations:
Bearer
query Parameters
locality
string

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Получить список плагинов.

Authorizations:
Bearer

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Получить древо логов.

Authorizations:
Bearer
path Parameters
taskId
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Получить список сообщений.

Предназначен для получения списка логов сообщений с фильтрацией.

Authorizations:
Bearer
path Parameters
taskId
required
string
Request Body schema:
groupingOperator
string or null

Оператор группировки фильтра.

Array of objects or null (LoggerRequestFilterExpression)

Список фильтров.

Responses

Request samples

Content type
{
  • "groupingOperator": "string",
  • "lines": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Получить список процессов.

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

Authorizations:
Bearer
path Parameters
taskId
required
string
Request Body schema:
groupingOperator
string or null

Оператор группировки фильтра.

Array of objects or null (LoggerRequestFilterExpression)

Список фильтров.

Responses

Request samples

Content type
{
  • "groupingOperator": "string",
  • "lines": [
    ]
}

Response samples

Content type
application/json
{
  • "taskId": "string",
  • "lines": [
    ],
  • "linesNumber": 0
}

Получить информацию о задаче. Если передан заголовок Breadcrumb - возвращает позицию задачи в очереди.

Authorizations:
Bearer
path Parameters
taskId
required
string
header Parameters
Breadcrumb
string

Responses

Response samples

Content type
application/json
{
  • "statuses": [
    ],
  • "executingDuration": 0,
  • "taskInQueue": 0
}

Получить информацию об очереди задач.

Authorizations:
Bearer
header Parameters
Breadcrumb
required
string

Responses

Response samples

Content type
application/json
{
  • "tenant": "string",
  • "queues": [
    ]
}

Получить информацию об очереди задач в разрезе всех тенантов.

Authorizations:
Bearer
header Parameters
Breadcrumb
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Отменить выполнение задачи.

Authorizations:
Bearer
path Parameters
taskId
required
string
header Parameters
Breadcrumb
required
string

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

License

Получить лицензии.

Authorizations:
Bearer

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Отвязать лицензию.

Authorizations:
Bearer
path Parameters
licenseId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Привязать лицензию к организации.

Authorizations:
Bearer
path Parameters
tenantName
required
string
Request Body schema: multipart/form-data
license
required
string <binary>

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Привязать лицензию к организации по ключу.

Authorizations:
Bearer
path Parameters
tenantName
required
string
apiKey
required
string

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Получить XML файл для офлайн запроса на предоставление лицензии.

Authorizations:
Bearer
Request Body schema:
required
productCode
required
string

Приложение.

organisationName
required
string

Наименование организации клиента.

clientEmail
required
string

E-mail клиента.

productPin
required
string

Пин-код продукта.

Responses

Request samples

Content type
{
  • "productCode": "string",
  • "organisationName": "string",
  • "clientEmail": "string",
  • "productPin": "string"
}

Response samples

Content type
application/json
{
  • "message": "string"
}

Получить статистику по лицензиям.

Authorizations:
Bearer
query Parameters
startDateTime
required
string <date-time>
endDateTime
required
string <date-time>
tenantName
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Tenant

Получить все организации со всеми их пользователями из БД.

Authorizations:
Bearer

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Создать организацию в БД.

Authorizations:
Bearer
Request Body schema:
required
name
required
string [ 1 .. 255 ] characters ^[A-Za-z0-9]+$

Название организации.

displayName
required
string or null [ 1 .. 255 ] characters

Отображаемое название организации.

email
required
string <axelot@axelot.ru> [ 6 .. 255 ] characters ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2...

Почта организации.

locality
required
string <ru-RU> [ 2 .. 16 ] characters
Default: "ru-RU"

Локализация организации. Основные локализации: ru-RU, en-EN.

Responses

Request samples

Content type
{
  • "name": "^A$",
  • "displayName": "string",
  • "email": "^a@a\\.a{2,}$",
  • "locality": "ru-RU"
}

Response samples

Content type
application/json
{
  • "name": "^A$",
  • "displayName": "string",
  • "email": "^a@a\\.a{2,}$",
  • "locality": "ru-RU"
}

Обновить организацию в БД.

Authorizations:
Bearer
Request Body schema:
required
name
required
string [ 1 .. 255 ] characters

Название организации.

displayName
string or null [ 1 .. 255 ] characters

Отображаемое название организации.

email
string or null <axelot@axelot.ru> [ 6 .. 255 ] characters ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2...

Почта организации.

locality
string or null <ru-RU> [ 2 .. 16 ] characters
Default: "ru-RU"

Локализация организации. Основные локализации: ru-RU, en-EN.

Responses

Request samples

Content type
{
  • "name": "string",
  • "displayName": "string",
  • "email": "^a@a\\.a{2,}$",
  • "locality": "ru-RU"
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "displayName": "string",
  • "email": "^a@a\\.a{2,}$",
  • "locality": "ru-RU"
}

Удалить организации из БД.

Authorizations:
Bearer
path Parameters
tenantName
required
string

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

User

Создать нового пользователя в БД.

Authorizations:
Bearer
Request Body schema:
required
login
required
string [ 1 .. 255 ] characters ^[A-Za-z0-9]+$

Логин.

password
required
string [ 6 .. 127 ] characters

Пароль.

tenantName
required
string [ 1 .. 255 ] characters

Название организации.

role
string or null [ 1 .. 255 ] characters
Default: null

Роль. Основные роли: GlobalAdmin, Admin или без роли.

expires
required
string <date-time>

Дата, до какого числа активен аккаунт.

Responses

Request samples

Content type
{
  • "login": "^A$",
  • "password": "string",
  • "tenantName": "string",
  • "role": null,
  • "expires": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "login": "string",
  • "expires": "2019-08-24T14:15:22Z",
  • "role": "string",
  • "tenantName": "string"
}

Обновить пользователя в БД.

Authorizations:
Bearer
Request Body schema:
required
login
required
string [ 1 .. 255 ] characters

Логин.

password
string [ 6 .. 127 ] characters

Пароль.

tenantName
string [ 1 .. 255 ] characters

Название организации.

role
string or null [ 1 .. 255 ] characters

Роль. Основные роли: GlobalAdmin, Admin или без роли. Передача пустой строки убирает назначенную роль.

expires
string <date-time>

Дата, до какого числа активен аккаунт.

Responses

Request samples

Content type
{
  • "login": "string",
  • "password": "string",
  • "tenantName": "string",
  • "role": "string",
  • "expires": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "login": "string",
  • "expires": "2019-08-24T14:15:22Z",
  • "role": "string",
  • "tenantName": "string"
}

Удалить пользователя из БД.

Authorizations:
Bearer
path Parameters
login
required
string
tenantName
required
string

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}