Перейти к основному содержимому

PUT /cards

Описание

Обновляет данные указанной карточки и возвращает пустой json объект.

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

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

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

НазваниеТипОписание
idnumberОбязательный. ID карточки, которую нужно обновить.

Тело запроса

Сервер должен получить json объект с объектом карточки, содержащим все свойства карточки (как неизменённые, так и новые/изменённые).

НазваниеТипОписание
labelstringОбязательный. Название карточки, которую нужно обновить.
descriptionstringОбязательный. Описание карточки.
columnnumberОбязательный. ID колонки, к которой относится карточка.
rownumberОбязательный. ID строки, к которой относится карточка.
start_datestringОбязательный. Дата начала в формате ISO yyyy-MM-dd'T'HH:mm:ss.SSSXXX
end_datestringОбязательный. Дата окончания в формате ISO yyyy-MM-dd'T'HH:mm:ss.SSSXXX
progressnumberОбязательный. Значение прогресс-бара в диапазоне от 0 до 100.
attachedobjectОбязательный. Массив с данными прикрепленных файлов. Пример объекта смотрите в разделе cards
colorstringОбязательный. Цвет верхней линии карточки в HEX формате.
prioritynumberОбязательный. ID приоритета карточки.
usersobjectОбязательный. Массив с ID назначенных пользователей. Пример объекта смотрите в разделе cardShape

Пример:

{
"card": {
"label": "Drag and drop",
"description": "",
"column": 3,
"row": 1,
"start_date": null,
"end_date": "2018-01-01T00:00:00Z",
"progress": 100,
"attached": [],
"color": "#58C3FE",
"priority": 2,
"users": []
},
}

Другой пример объекта карточки вы можете найти в разделе cards.

Ответ

В случае успешного выполнения возвращается пустой json объект.

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


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