Закладки ======== .. contents:: Содержание .. _api_bookmarks_intro: Введение ######## Просмотр и управление закладками пользователя .. _api_bookmarks_list: Список папок в закладках ######################## Запрос:: GET https://api.service-kp.com/v1/bookmarks Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, 'items': [ { 'id': 1, 'title': 'Семейные', 'views': 10, 'count': 23, 'created': 12345667, 'updated': 12345678 } ] ] .. _api_bookmarks_show: Список фильмов/сериалов в папке ############################### Два варианта запросов, для обратной совместимости. Запрос:: GET https://api.service-kp.com/v1/bookmarks/view?folder= GET https://api.service-kp.com/v1/bookmarks/ Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, 'folder': { 'id': 1, 'title': 'Семейные', 'views': 10, 'created': 12345667, 'updated': 12345678 } 'items': [] ] Пример содержания *items* смотрите в: :ref:`Список медиа ` .. _api_bookmarks_get_item_folders: Список папок в которых присутствует фильм ######################################### Запрос:: GET https://api.service-kp.com/v1/bookmarks/get-item-folders?item= Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, 'folders': [ { 'id': 1, 'title': 'Семейные', 'views': 10, 'created': 12345667, 'updated': 12345678 } ] ] .. _api_bookmarks_create: Создать папку ############# Запрос:: POST https://api.service-kp.com/v1/bookmarks/create Параметры запроса: * **title** - название папки. Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, 'folder': { 'id': 134, 'title': 'Название', 'views': 10, 'created': 12312334, 'updated': 1231233123, } ] .. _api_bookmarks_add: Добавление фильма в папку ######################### Запрос:: POST https://api.service-kp.com/v1/bookmarks/add Параметры запроса: * **item** - идентификатор фильма * **folder** - идентификатор папки Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, ] .. _api_bookmarks_remove_folder: Удаление папки ############## Запрос:: POST https://api.service-kp.com/v1/bookmarks/remove-folder Параметры запроса: * **folder** - идентификатор папки Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, ] .. _api_bookmarks_remove_item: Удаление фильма из папки/папок ############################## Запрос:: POST https://api.service-kp.com/v1/bookmarks/remove-item Параметры запроса: * **item** - идентификатор фильма * **[folder]** - идентификатор папки, если отсутствует - удаляем из всех папок. Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, ] .. _api_bookmarks_toggle_item: Переключение добвить/удалить фильм ################################## Если фильм отсутствует в заданной папке, он добавится в нее, иначе удалится. Запрос:: POST https://api.service-kp.com/v1/bookmarks/toggle-item Параметры запроса: * **item** - идентификатор фильма * **folder** - идентификатор папки Ответ:: HTTP/1.1 200 OK Content-Type: application/json [ 'status': 200, ]