Массовое создание проверок соответствия ПО

Запрос

Тип	Метод
POST	/software_compliance_checks/mass_create

Описание: метод создаёт несколько результатов проверок соответствия ПО из переданного списка.

Каждый объект обрабатывается отдельно. Перед созданием выполняется валидация данных. Если при обработке отдельного объекта возникает ошибка, информация о ней возвращается в поле error соответствующего элемента массива results.

Если при создании объекта возникает ошибка уникального ограничения, выполняется обновление существующего объекта по полям уникального ограничения, которые вызвали ошибку.

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

POST

http://127.0.0.1/cruddy/v2/software_compliance_checks/mass_create

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

Параметр	Тип данных	Обязательность	Описание
items	Array<object>	Required	Список объектов для создания

Каждый элемент массива items соответствует структуре SoftwareComplianceCheckNoRelations.

Пример тела запроса

{
  "items": [
    {
      "<параметр>": "<значение>"
    },
    {
      "<параметр>": "<значение>"
    }
  ]
}

Успешный ответ

Статус код: 200 – запрос успешно обработан.

Формат: JSON.

Параметры ответа:

Параметр	Тип данных	Описание
results	Array<object>	Список результатов обработки объектов
results[].result	SoftwareComplianceCheck или null	Созданный или обновлённый объект. Возвращается при успешной обработке
results[].error	string или null	Текст ошибки обработки объекта

Для каждого элемента массива items возвращается отдельный результат обработки:

• при успешном создании или обновлении поле result содержит объект, а error имеет значение null;
• при ошибке поле error содержит описание ошибки, а result имеет значение null.

Пример ответа

{
  "results": [
    {
      "result": {
        "id": "7bc42fd2-057c-4117-b367-8528bec75c80"
      },
      "error": null
    },
    {
      "result": null,
      "error": "текст ошибки"
    }
  ]
}

Другие возможные ответы

Код	Ответ	Описание
400	Bad Request	Ошибка в теле запроса или при его обработке
401	can't get user info:	Невозможно аутентифицировать пользователя
500	Internal Server Error	Ошибка сервера

Возможные ошибки:

• 400 — "Bad Request" — неверный тип параметра запроса либо отсутствует обязательный параметр;
• 400 — "read body: ..." — ошибка чтения тела запроса;
• 400 — "empty items" — список объектов не передан или пуст;
• 400 — "parse request: ..." — ошибка парсинга запроса;
• 400 — "parse request to map: ..." — ошибка парсинга запроса в карту;
• 401 — "can't get user info:" — невозможно аутентифицировать пользователя;
• 500 — "Internal Server Error" — ошибки сервера.

Пример ответа с кодом 400

{
  "error": "empty items"
}

Пример ответа с кодом 401

{
  "error": "can't get user info:"
}

Пример ответа с кодом 500

{
  "error": "Internal Server Error"
}