PUT /cards/{id}/move

Описание

Перемещает карточки на указанную позицию

Этот маршрут обрабатывает HTTP PUT запрос, отправляемый по пути cards/{id}/move.

Параметры пути

В строке запроса передаётся следующий параметр:

Имя	Тип	Описание
id	number	Обязательный. ID карточки, которую нужно переместить. Если требуется переместить несколько карточек, id должен быть равен 0

информация

При перемещении нескольких карточек убедитесь, что id установлен в 0, иначе (если задано другое значение) будет перемещена только одна карточка с указанным id.

Тело запроса

Сервер ожидает получить JSON-объект со следующими свойствами:

Имя	Тип	Описание
id	number	Обязательный. ID перемещаемой карточки.
columnId	number	Обязательный. ID колонки, в которую перемещается карточка.
rowId	number	Обязательный. ID строки, в которую перемещается карточка.
before	number	Необязательный. ID карточки, перед которой должна быть размещена перемещаемая карточка.
batch	object	Обязательный для мультивыбора. Массив объектов карточек, которые перемещаются.

Пример:

{
    "id": 4,
    "columnId": 2,
    "rowId": 1,
    "before": "7"
}

Если перемещается несколько карточек, свойство batch должно содержать массив всех перемещаемых объектов карточек:

{
    "batch": [
        {
            "id": 2,
            "columnId": 1,
            "rowId": 1,
            "before": "1"
        },
        {
            "id": 7,
            "columnId": 1,
            "rowId": 1,
            "before": "1"
        }
    ]
}

Ответ

Сервер возвращает JSON-объект с ID карточки (если перемещается одна карточка) или с ID, равным 0, при операции с несколькими карточками.

Пример:

Ответ на запрос при операции с одной карточкой

{
    "id": 4
}

Ответ на запрос при операции с несколькими карточками

{
    "id": 0
}

HTTP статус код показывает, успешен ли запрос (response.status == 200) или произошла ошибка (response.status == 500).

---

Связанные статьи: Работа с сервером