История
=======

.. contents:: Содержание


.. _api_history_intro:

Введение
########

Управление историей просмотров

.. _api_history_list:

Получение истории просмотров
############################

Параметры запроса:
    * *[page]* - номер страницы
    * *[perpage]* - кол-во на страницы, по умолчанию 20, максимум 50.

Запрос::

    GET https://api.service-kp.com/v1/history


Ответ::


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

    {
        "history": [
            {
                "time": 123, // время где остановились
                "counter": 1, //сколько раз смотрели данный media
                "first_seen": 12344545, // unixtime, когда впервые посмотрели media
                "last_seen": 1234556, // unixtime, когда последний раз посмотрели media
                "item": {}, // описание item
                "media": {},  // описание media
            }
        ],
        "pagination": {
            "total": 123,
            "current": 1,
            "perpage: 123,
            "total_items": 123,
        },
    }

.. _api_history_clear_for_media:

Очистить просмотр для media
###########################

Параметры запроса:
    * *id* - идентификатор media

Запрос::

    POST https://api.service-kp.com/v1/history/clear-for-media?id=123


Ответ::


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


.. _api_history_clear_for_season:

Очистить просмотр для media
###########################

Параметры запроса:
    * *id* - идентификатор season

Запрос::

    POST https://api.service-kp.com/v1/history/clear-for-season?id=123


Ответ::


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


.. _api_history_clear_for_item:

Очистить просмотр для item
###########################

Параметры запроса:
    * *id* - идентификатор item

Запрос::

    POST https://api.service-kp.com/v1/history/clear-for-item?id=123


Ответ::


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