Skip to main content

POST - Перестановка графических планов

Метод POST /locations/{id}/graphic-plans/reorder используется для изменения порядка графических планов, связанных с определённым местоположением. Этот запрос позволяет клиентам указать новый порядок, отправив массив ID графических планов.

Детали запроса​

HTTP Метод: POST
Конечная точка: /locations/{id}/graphic-plans/reorder
Content-Type: application/json

Параметры запроса:​

ИмяОписаниеТипОбязательное
idУникальный идентификатор местоположенияstring ($uuid)Да

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

ИмяОписаниеТипОбязательное
graphicPlanIdsМассив ID графических планов в новом порядкеarrayДа

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

URL:

POST /locations/638b90c5-7965-49ae-a02b-1b190cb216db/graphic-plans/reorder

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

{
  "graphicPlanIds": [
    "12a8af51-52f6-409b-82c2-08bbd5df18c2",
    "78691588-9adf-457b-ad56-3426e6d8e3d9"
  ]
}

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

Код ответа: 200 OK
Тело ответа:

{
  "graphicPlanIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}

Ошибки​

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

Возникает, когда отправленные данные некорректны, например, если в массиве graphicPlanIds есть дублирующиеся ID.

Тело ответа:​

{
  "message": "invalid input data",
  "code": "input.data.invalid",
  "timestamp": "2023-03-07T05:57:59.315Z",
  "details": [
    {
      "message": "collection elements non-unique",
      "code": "input.data.invalid",
      "identifier": "requests"
    }
  ]
}

Решение:

  • Убедитесь, что в graphicPlanIds только уникальные ID.
  • Проверьте, чтобы все ID были правильно отформатированы.

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

Возникает, когда указанное местоположение с данным id не существует.

Тело ответа:​

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

Решение:

  • Проверьте точность указания id.
  • Убедитесь, что местоположение существует в системе.

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

Возникает, когда сервер не может обработать предоставленный формат данных.

Тело ответа:​

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

Решение:

  • Убедитесь, что запрос использует правильный тип контента application/json.
  • Проверьте корректность форматирования тела запроса.

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

Возникает из-за непредвиденной проблемы на сервере.

Тело ответа:​

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

Решение:

  • Повторите запрос через некоторое время.
  • Свяжитесь с технической поддержкой, если проблема не устранена.

Резюме​

Метод POST /locations/{id}/graphic-plans/reorder позволяет изменить порядок графических планов для конкретного местоположения. Чтобы избежать ошибок:

  1. Убедитесь, что указан правильный id для местоположения.
  2. Проверьте, чтобы в graphicPlanIds были уникальные и правильно отформатированные ID.
  3. Используйте правильный тип контента application/json для запроса.