Перейти к содержанию

Массовое обновление значений дополнительных полей

Запрос

Тип Метод
POST /custom_field_values/mass_update

Описание: При выполнении запроса выбранным параметрам значений дополнительных полей будут присвоены новые значения.

Работает по принципу частичного обновления, т.е. будут обновлены только те поля модели которые были переданы в запросе.

Всем объектам будут присвоены одинаковые значения в переданных полях.

Изменение связей не поддерживается.

Метод транзакционный, если произошла ошибка изменения одного из объектов, откатываются все изменения.

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

POST
http://127.0.0.1/cruddy/v2/custom_field_values/mass_update

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

Параметр Тип данных Обязательность Описание
ids Array<string> Required Список ID объектов
fields DefaultObject Required Словарь новых значений полей модели данных CustomFieldValue
fields{param_1} Зависит от изменяемого параметра в соответствии с моделью Optional Первый параметр, который необходимо изменить в соответствии с моделью объекта, например custom_field_id
fields{param_n} Зависит от изменяемого параметра в соответствии с моделью Optional N-ый параметр, который необходимо изменить в соответствии с моделью объекта, например service_asset_finding_id
Пример тела запроса

{
  "ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "fields": {
    "custom_field_id": "a0fa4fc5-cabd-4219-9751-6d126c809065",
    "service_asset_finding_id": "08a5c673-3c5c-48ab-bf6c-f2ee47d8df88",
    "string_value": "string",
    "integer_value": 0,
    "float_value": 0,
    "date_value": "2023-12-20T00:00:01.652259Z",
    "json_value": {},
    "boolean_value": true,
    "field_type": "string",
    "occurrence_id": "8508ee33-23a1-4a06-ae02-1eb167405e7b"
  }
}

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

Статус код: 200 – объекты успешно изменены.

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

Код Ответ Описание
400 1. Bad Request
2. ids is empty
3. fields is empty
4. exceeded maximum length for a value
5. id should be uuid format
1. Неверный тип параметра запроса, либо отсутствует обязательный параметр
2. Список ID не передан
3. Новые значения полей не переданы
4. Значение превышает максимально допустимую длину
5. Недопустимый формат ID
404 not found Объект не найден
409 name_already_used Попытка создать объект с существующим уникальным атрибутом
500 Internal Server Error Другие ошибки сервера

Примечание: Текст ошибки не фиксированный, может изменяться в зависимости от фактического ответа получателя запроса.

Пример ответа
Код 400

{
  "error": "Bad Request",
  "error_code": 400
}

Код 404

{
  "error": "Not Found",
  "error_code": 404
}

Код 409

{
  "error": "name_already_used",
  "error_code": 409,
  "extra": {
    "fields": [
      "name"
    ]
  }
}

Код 500

{
  "error": "Internal Server Error",
  "error_code": 500
}