Метод используется для получения списка закладок для pdf книги.
См. также:
[w_replace_my_pdf_notes] Перезапись закладок pdf книги;
[w_set_pdf_bookmark_lock] Запросить блокировку закладок pdf книг.
ID функции
r_my_pdf_notes
Кто может вызывать
Авторизованный пользователь
Авторизованное приложение
Принимаемые параметры
art* – ID pdf книги, закладки от которой нас интересуют;
group – ID групп, закладки которых нас интересуют. Если не передан – сервер вернёт все закладки. Принимает значения 0-1, имеются следующие «базовые» группу (классы выделения):
0 – текущая позиция в главе (в этом классе закладка всегда одна);
1 – закладка.
Возвращаемые значения
my_notes* – массив, содержащий список заметок/закладок данной книги:
- id* – ID заметки;
- group* – группа (см. параметр group в запросе выше);
- last_update* – время последней модификации записи;
- page – страница, на которой закладка;
- percent* – процент прочитанного. Возвращается, если group = 0;
Если закладки для книги отсутствуют, то массив my_notes будет пустым.
Возможные ошибки
error_code | error_message | Описание |
---|---|---|
101087 | Несуществующая книга | Книга, к которой произошла попытка сохранить заметки, не существует в каталоге ЛитРес |
101144 | Позиция timet некорректна | Позиция, описанная в file, time_start или time_end, некорректна: находится за пределами книги или соответствующие узлы не существуют и т.п. |
Пример запроса на сервер
{ "app": "1", "time": "2018-11-07T16:21:02+03:00", "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c", "sid": "7bad5f2fb752ee957a4ab74aaac7711g", "requests": [ { "func": "r_my_pdf_notes", "id": "r_my_pdf_notes", "param": { "art": "568640" } } ] }
Пример ответа сервера
{ "success": true, "time": "2018-11-07T16:21:02+03:00", "r_my_pdf_notes" : { "success" : true, "r_my_pdf_notes": [ { "id": "65830123-26b8-4b07-8098-c18229e5026e", "group": "0", "page": "8" "last_update": "2018-11-07T16:21:02+03:00", "percent" : "53" }, { "id": "65830123-26b8-4b07-8098-c18229e5026f", "group": "1", "last_update": "2018-11-07T16:21:15+03:00", "page": "8" "percent" : "34.12" } ] } }