Записать на сервер свежие версии закладок. Все переданные в запросе закладки (идентифицируются по ID) будут замещены на сервере новой версией. Если закладки с таким ID не было, она создаётся. Перед вызовом, во избежание коллизий, следует запросить блокировку w_set_pdf_bookmark_lock;
ID функции
w_replace_my_pdf_notes
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
art* – ID книги, к которой относятся закладки;
my_notes* – массив закладок, которые следует перезаписать. По структуре соответствует ответу из r_my_pdf_notes;
lock_id* – ID блокировки, полученный в w_set_pdf_bookmark_lock. Время блокировки – 20 минут.
Возвращаемые значения
Отсутствуют.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101019 | Invalid lock ID | ID блокировки невалиден или устарел. Следует запросить новую блокировку, параллельно получив с сервера свежие заметки/закладки, и затем объединить их с локальными (кто-то их уже мог изменить на сервере) |
101062 | Invalid art ID | Книга с таким ID книги не найдена |
| 101167 | more than one group=0 quotes | Позиция тексте (параметр group=0, см. r_my_pdf_notes) может быть только одна |
Пример запроса на сервер
{
"app": "1",
"time": "2018-08-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"sid": "78838d3c7fbf640a4c52956569bef3c685",
"requests": [
{
"func": "w_replace_my_pdf_notes",
"id": "replace_my_pdf_notes",
"param": {
"art": "459822",
"lock_id": "bf43f954-256c-11e1-9474-102aa4b7a826",
"my_notes": [
{
"id": "65830123-26b8-4b07-8098-c18229e5026e",
"group": "0",
"page": "5"
"last_update": "2018-08-07T16:21:02+03:00",
"percent": "34.12",
},
]
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2018-08-07T16:21:02+03:00",
"w_replace_my_pdf_notes": {
"success": true
}
}