Для исключения конкуренции при записи на сервер закладок приложению следует получить «блокировку» параллельно с получением актуального списка закладок (r_my_epub_notes или r_my_epub_notes_incremental). Затем следует локально смержить закладки с сервера (где они могли обновиться) с локальными закладками, и после этого сохранить полученный набор закладок на сервер, передав ID блокировки.
ID функции
w_set_epub_bookmark_lock
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
art* – ID книги, цитаты по которой следует заблокировать.
Возвращаемые значения
lock_id – ID блокировки, передаётся в w_replace_my_epub_notes. Время блокировки – 20 минут.
Возможные ошибки
error_code | error_message | Описание |
---|---|---|
101062 | Invalid art ID | Книга с таким ID книги не найдена. |
Пример запроса на сервер
{ "app": "1", "time": "2014-11-07T16:21:02+03:00", "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c", "sid": "78838d3c7fbf640a4c52956569bef3c685", "requests": [ { "func": "w_set_epub_bookmark_lock", "id": "w_set_epub_bookmark_lock", "param": { "art": "9658514" } } ] }
Пример ответа сервера
{ "success": true, "time": "2014-11-07T16:21:02+03:00", "w_set_epub_bookmark_lock": { "success": true, "lock_id": "c0b44f53-220f-412a-bdc3-6f420d00e6d4" } }