PUT /cards/{id}/move

Описание

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

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

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

В URL запроса должен быть включён следующий параметр:

Имя	Тип	Описание
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).

---

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