Skip to main content

PATCH - Массовое обновление данных точек

Описание​

Метод PATCH /locations/points/batch используется для обновления данных нескольких точек за один запрос. Запрос принимает список точек с данными для обновления.

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

Параметры​

ПараметрТипОбязательныйОписание
idстрока (UUID)ДаУникальный идентификатор точки.
nameстрокаНетНазвание точки.

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

[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "P002"
  }
]

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

Код ответа​

200 OK

Тело ответа​

[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "locationId": "12a8af51-52f6-409b-82c2-08bbd5df18c2",
    "name": "P002",
    "type": "VIRTUAL",
    "latitude": null,
    "longitude": null,
    "graphicPlans": [],
    "rfidCode": null,
    "qrCode": null,
    "tags": [
      "tag1"
    ]
  }
]

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

400 Неверные данные запроса​

Код ответа​

400 Bad Request

Тело ответа​

{
  "message": "invalid input data",
  "code": "input.data.invalid",
  "timestamp": "2023-03-07T05:57:59.315Z",
  "details": [
    {
      "message": "must not be null",
      "code": "input.data.invalid",
      "identifier": "requestPoints[0].graphicPlans[0].id"
    }
  ]
}

Описание​

Предоставленные данные не соответствуют ожидаемому формату (например, отсутствуют обязательные поля).

404 Ресурс не найден​

Код ответа​

404 Not Found

Тело ответа​

{
  "message": "resource wasn't found",
  "code": "not.found",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание​

Ресурс с указанным идентификатором не был найден.

406 Несоответствие типов контента​

Код ответа​

406 Not Acceptable

Тело ответа​

{
  "message": "mismatch in the types of content",
  "code": "not.acceptable",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание​

Тип контента запроса не соответствует ожидаемому типу.

500 Внутренняя ошибка сервера​

Код ответа​

500 Internal Server Error

Тело ответа​

{
  "message": "internal server error",
  "code": "internal.server.error",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание​

Произошла внутренняя ошибка на сервере. Повторите попытку позже или обратитесь в техническую поддержку.

Резюме​

Метод PATCH /locations/points/batch позволяет обновлять данные нескольких точек за один запрос. Убедитесь, что предоставленные данные корректны и соответствуют ожидаемому формату, чтобы избежать ошибок.