Формулировка проблемы: нет возможности изменить статус заметки на "завершена" при помощи API метода.
Решение: необходимо реализовать API метод, который будет изменять статус заметки на "завершена".
URL метода: /rest/api/diary/tasks/complete
Тип запроса: GET
.
Метод принимает следующие входной параметр:
taskID
- uuid
заметки
(обяз.), которую необходимо завершить.
Метод меняет статус указанной заметки на статус "Завершена". Действие производится от имени авторизованного пользователя.
Метод возвращает json-объект с полями:
errorCode
- код выполнения:
0 - успешно
иначе - ошибка
errorMessage
- сообщение о результате
выполнения (успешном либо неуспешном).
Пример запроса:
/rest/api/diary/tasks/complete?taskID=e6fc40b0-9fe4-11e6-9ce4-001ef892a4ee
Пример возвращаемого объекта:
{ "errorCode": 0, "errorMessage": "Заметка успешно завершена" }
Альтернативные потоки событий.
Альтернативный поток №1. Не передан или передан некорректный
(несуществующий) параметр taskID
. Сервер
возвращает ошибку HTTP 400 с сообщением:
{ "errorCode" : 3, "errorMessage" : "Не передан или передан некорректный параметр taskID" }
действие не выполняется.
Альтернативный поток №2. Невозможно поменять статус заметки на "завершена" (заметка завершена, удалена). Сервер возвращает ошибку HTTP 403 с сообщением:
{ "errorCode" : 13, "errorMessage" : "Невозможно завершить указанную заметку" }
действие не выполняется.