Закладки

Введение

Просмотр и управление закладками пользователя

Список папок в закладках

Запрос:

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
        }
    ]
]

Список фильмов/сериалов в папке

Два варианта запросов, для обратной совместимости.

Запрос:

GET https://api.service-kp.com/v1/bookmarks/view?folder=<id>
GET https://api.service-kp.com/v1/bookmarks/<id>

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
    'folder': {
        'id': 1,
        'title': 'Семейные',
        'views': 10,
        'created': 12345667,
        'updated': 12345678
    }
    'items': []
]

Пример содержания items смотрите в: Список медиа

Список папок в которых присутствует фильм

Запрос:

GET https://api.service-kp.com/v1/bookmarks/get-item-folders?item=<id>

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
    'folders': [
        {
            'id': 1,
            'title': 'Семейные',
            'views': 10,
            'created': 12345667,
            'updated': 12345678
        }
    ]
]

Создать папку

Запрос:

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,
    }
]

Добавление фильма в папку

Запрос:

POST https://api.service-kp.com/v1/bookmarks/add
Параметры запроса:
  • item - идентификатор фильма
  • folder - идентификатор папки

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
]

Удаление папки

Запрос:

POST https://api.service-kp.com/v1/bookmarks/remove-folder
Параметры запроса:
  • folder - идентификатор папки

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
]

Удаление фильма из папки/папок

Запрос:

POST https://api.service-kp.com/v1/bookmarks/remove-item
Параметры запроса:
  • item - идентификатор фильма
  • [folder] - идентификатор папки, если отсутствует - удаляем из всех папок.

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
]

Переключение добвить/удалить фильм

Если фильм отсутствует в заданной папке, он добавится в нее, иначе удалится.

Запрос:

POST https://api.service-kp.com/v1/bookmarks/toggle-item
Параметры запроса:
  • item - идентификатор фильма
  • folder - идентификатор папки

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
]