Skip to main content

POST - Добавление графических планов в местоположение

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

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

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

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

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

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

ИмяОписаниеТипОбязательное
plansМассив файлов с графическими планами для загрузкиarray (files)Да

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

URL:

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

Тело запроса:
Content-Type: multipart/form-data

plans: [graphic_plan1.png, graphic_plan2.pdf]

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

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

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

Ошибки​

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

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

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

{
  "message": "invalid input data",
  "code": "input.data.invalid",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Решение:

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

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

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

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

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

Решение:

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

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

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

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

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

Решение:

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

Заключение​

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

  1. Укажите корректный UUID в параметре id.
  2. Используйте правильный формат multipart/form-data для тела запроса.
  3. Включите файлы графических планов в поле plans.