Формулировка проблемы: нет возможности получить описание заметки.
Решение: необходимо реализовать API-метод, который будет возвращать описание заметки по ее идентификатору.
URL метода: /rest/api/diary/tasks/get
Тип запроса: GET
.
Метод принимает следующие входные параметры:
taskID
- uuid
заметки
(обяз.);
locale
(не обяз.) - код локали (при
отсутствии параметра используется
язык
системы по умолчанию).
Метод возвращает описание заметки с указанным идентификатором.
В случае успешного выполнения метод возвращает объект
JSON
, состоящий из следующих полей:
taskID
- uuid
заметки;
task
- текст заметки;
start
- дата и время начала исполнения
заметки, в формате yyyy-MM-dd HH:mm:ss
;
finish
- дата и время завершения исполнения
заметки, в формате yyyy-MM-dd HH:mm:ss
;
wholeDay
- признак исполнения заметки в
течение дня. Одно из следующих значений:
true
- установлен срок исполнения "в
течение дня";
false
- не установлен срок исполнения
"в течение дня".
Пример запроса:
rest/api/diary/tasks/get?taskID=e6fc40b0-9fe4-11e6-9ce4-001ef892a4ee
Пример возвращаемого массива:
{ "taskID" : "e6fc40b0-9fe4-11e6-9ce4-001ef892a4ee", "task" : "заметка №1", "start" : "2016-12-05 10:00:00", "finish" : "2016-12-05 16:00:00", "wholeDay" : false }
Альтернативные потоки событий
Альтернативный поток №1. Не передан или передан некорректный
(несуществующий) параметр taskID
. Сервер
возвращает ошибку HTTP 400 c cообщением:
{ "errorCode": 3, "errorMessage": "Не передан или передан некорректный параметр taskID" }
действие не выполняется.