Метод используется для получения списка закладок для 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* – процент прочитанного (например 5.66 - в базу запишется целое т.е. 6). Возвращается, если 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"
}
]
}
}