### GET /v1/device - List devices response

Source: https://kinoapi.com/api_device.html

Example response from the device list endpoint. Shows a JSON structure with a status and devices array, each containing device details like id, title, hardware, software, created, updated, last_seen, is_browser, and settings.

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

[
    'status': 200,
    'devices': [
        {
            'id': 1,
            'title': 'AppleTV Hall',
            'hardware': 'AppleTV/5.3',
            'software': 'iOS/8.3'
            'created': 12345667,
            'updated': 12345678
            'last_seen': 12345678,
            'is_browser': 0,
            'settings: {
              // Список настроек
            }
        }
    ]
]
```

--------------------------------

### POST /oauth2/device (Error Example)

Source: https://kinoapi.com/authentication.html

Example of an error response when authentication fails, such as invalid client credentials. All errors except 'authorization_pending' are critical.

```APIDOC
## POST /oauth2/device (Error Example)

### Description
Example of an error response when authentication fails, such as invalid client credentials. All errors except 'authorization_pending' are critical.

### Method
POST

### Endpoint
https://api.service-kp.com/oauth2/device

### Parameters
#### Query Parameters
- **grant_type** (string) - Required - Must be `device_code`.
- **client_id** (string) - Required - The client identifier.
- **client_secret** (string) - Required - The client secret.

### Request Example
```
POST https://api.service-kp.com/oauth2/device?grant_type=device_code&client_id=wrongclient&client_secret=mysecret
```

### Response
#### Error Response (400)
- **error** (string) - The error code (e.g., invalid_client).
- **error_description** (string) - A human-readable description of the error.

#### Response Example
```
HTTP/1.1 400 Bad Request
Content-Type: application/json
Cache-Control: no-store

{
  "error":"invalid_client",
  "error_description":"The client credentials are invalid"
}
```
```

--------------------------------

### Response for listing movies/series in a folder

Source: https://kinoapi.com/api_bookmarks.html

Example JSON response for the folder listing endpoints. Contains a 'folder' object with id, title, views, created, and updated fields, and an 'items' array (empty in this example).

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

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

--------------------------------

### GET /v1/genres Response

Source: https://kinoapi.com/api_video.html

Example JSON response from the /v1/genres endpoint. Note the response contains an array of genre objects with 'id', 'title', and 'type' fields. The example includes a syntax error (missing comma) and unquoted strings, which may be illustrative.

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

[
    {
        'id': 1,
        'title': 'Комедия',
        'type': 'movie'
    },
    {
        'id':10,
        'title': 'Катастрофа',
        'type': 'docu'
    }
    {
        'id': 13,
        'title': Rock,
        'type': music
    }
]
```

--------------------------------

### GET /v1/device - List devices request

Source: https://kinoapi.com/api_device.html

Request to list all devices on the account. Uses the GET method on the /v1/device endpoint.

```http
GET https://api.service-kp.com/v1/device
```

--------------------------------

### GET /v1/device/info

Source: https://kinoapi.com/api_device.html

Returns information about the current device.

```APIDOC
## GET /v1/device/info

### Description
Returns information about the current device.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/device/info

### Response
#### Success Response (200)
- **status** (int) - Status code (200)
- **device** (object) - Device information.
  - **id** (int) - Device ID.
  - **title** (string) - Device title.
  - **hardware** (string) - Hardware identifier.
  - **software** (string) - Software identifier.
  - **created** (int) - Creation timestamp.
  - **updated** (int) - Update timestamp.
  - **last_seen** (int) - Last seen timestamp.
  - **is_browser** (int) - Indicates if the device is a browser (0 or 1).
  - **settings** (object) - List of settings.

#### Response Example
```
HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
    'device': {
        'id': 1,
        'title': 'AppleTV Hall',
        'hardware': 'AppleTV/5.3',
        'software': 'iOS/8.3'
        'created': 12345667,
        'updated': 12345678,
        'last_seen': 12345678,
        'is_browser': 0,
        'settings: {
          // Список настроек
        }
    }
]
```
```

--------------------------------

### Authentication error example: invalid_client

Source: https://kinoapi.com/authentication.html

Example of a critical authentication error response. All errors except 'authorization_pending' are critical and indicate problems. This example shows a 400 Bad Request with an 'invalid_client' error, meaning the client credentials are invalid.

```http
POST https://api.service-kp.com/oauth2/device?grant_type=device_code&client_id=wrongclient&client_secret=mysecret

HTTP/1.1 400 Bad Request
Content-Type: application/json
Cache-Control: no-store

{
  "error":"invalid_client",
  "error_description":"The client credentials are invalid"
}
```

--------------------------------

### GET bookmarks/view and GET bookmarks/<id> requests

Source: https://kinoapi.com/api_bookmarks.html

Two backward-compatible request variants for listing movies/series in a folder. The first uses the query parameter 'folder', the second uses the folder ID in the path.

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

--------------------------------

### Get device info by ID - GET /v1/device/123

Source: https://kinoapi.com/api_device.html

Retrieves information about a specific device by its ID. The response includes device details such as id, title, hardware, software, timestamps, and a settings object.

```http
GET https://api.service-kp.com/v1/device/123
```

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

[
    'status': 200,
    'device': {
        'id': 1,
        'title': 'AppleTV Hall',
        'hardware': 'AppleTV/5.3',
        'software': 'iOS/8.3'
        'created': 12345667,
        'updated': 12345678,
        'last_seen': 12345678,
        'settings: {
          // Список настроек
        }
    }
]
```

--------------------------------

### GET /v1/bookmarks

Source: https://kinoapi.com/api_bookmarks.html

Получить список папок в закладках пользователя.

```APIDOC
## GET /v1/bookmarks

### Description
Возвращает список папок в закладках пользователя.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/bookmarks

### Response
#### Success Response (200)
- **status** (integer) - Статус ответа.
- **items** (array) - Список папок.
  - **id** (integer) - Идентификатор папки.
  - **title** (string) - Название папки.
  - **views** (integer) - Количество просмотров.
  - **count** (integer) - Количество элементов в папке.
  - **created** (integer) - Время создания (timestamp).
  - **updated** (integer) - Время обновления (timestamp).

#### Response Example
```json
[
    'status': 200,
    'items': [
        {
            'id': 1,
            'title': 'Семейные',
            'views': 10,
            'count': 23,
            'created': 12345667,
            'updated': 12345678
        }
    ]
]
```
```

--------------------------------

### GET /v1/items/similar

Source: https://kinoapi.com/api_video.html

Retrieves a list of video items similar to a specified item by its ID.

```APIDOC
## GET /v1/items/similar

### Description
Retrieves a list of video items similar to a specified item by its ID.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/items/similar

### Parameters
#### Query Parameters
- **id** (string) - Required - Identifier of the item for which similar items are searched.

### Response
#### Success Response (200)
Returns a list of video items (see item response).
```

--------------------------------

### GET /v1/items/fresh

Source: https://kinoapi.com/api_video.html

Retrieves a list of fresh video content. Supports pagination and filtering by content type.

```APIDOC
## GET /v1/items/fresh

### Description
Retrieves a list of fresh video content. Supports pagination and filtering by content type.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/items/fresh

### Parameters
#### Query Parameters
- **type** (string) - Required - Type of video content (see content types)
- **page** (integer) - Optional - Current page number (default: 0)
- **perpage** (integer) - Optional - Number of items per page (default: 25)

### Response
#### Success Response
Returns a list of video content items (see Video Content section).
```

--------------------------------

### Response for get-item-folders

Source: https://kinoapi.com/api_bookmarks.html

Example JSON response containing a 'folders' array with folder objects (id, title, views, created, updated).

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

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

--------------------------------

### GET /v1/device/{id}

Source: https://kinoapi.com/api_device.html

Returns information about a specific device by its ID.

```APIDOC
## GET /v1/device/{id}

### Description
Returns information about a specific device by its ID.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/device/123

### Parameters
#### Path Parameters
- **id** (int) - Required - ID of the device.

### Response
#### Success Response (200)
- **status** (int) - Status code (200)
- **device** (object) - Device information.
  - **id** (int) - Device ID.
  - **title** (string) - Device title.
  - **hardware** (string) - Hardware identifier.
  - **software** (string) - Software identifier.
  - **created** (int) - Creation timestamp.
  - **updated** (int) - Update timestamp.
  - **last_seen** (int) - Last seen timestamp.
  - **settings** (object) - List of settings.

#### Response Example
```
HTTP/1.1 200 OK
Content-Type: application/json

[
    'status': 200,
    'device': {
        'id': 1,
        'title': 'AppleTV Hall',
        'hardware': 'AppleTV/5.3',
        'software': 'iOS/8.3'
        'created': 12345667,
        'updated': 12345678,
        'last_seen': 12345678,
        'settings: {
          // Список настроек
        }
    }
]
```
```

--------------------------------

### GET /v1/references/video-quality

Source: https://kinoapi.com/api_references.html

Retrieves the list of video qualities. Returns an array of items with id, title, and quality.

```APIDOC
## GET /v1/references/video-quality

### Description
Retrieves the list of video qualities.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/references/video-quality

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code
- **items** (array) - List of video qualities
  - **id** (integer) - Unique identifier
  - **title** (string) - Quality title (e.g., '480p')
  - **quality** (integer) - Quality value (e.g., 480)

#### Response Example
{
  "status": 200,
  "items": [
    {
      "id": 1,
      "title": "480p",
      "quality": 480
    },
    {
      "id": 2,
      "title": "720p",
      "quality": 720
    }
  ]
}
```

--------------------------------

### Trailer response

Source: https://kinoapi.com/api_video.html

Example JSON response for the trailer request, containing status and trailer details including URL and available files with quality and dimensions.

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

[
    {
        'status': 200,
        'trailer': {
            'id': 'l_54Jsdfkn',
            'url': 'http://youtube.com/watch?v=l_54Jsdfkn',
            'files': [
                {
                    'url': 'https://url.to.file',
                    'quality': 360,
                    'width: 480,
                    'height': 360,
                },
            ],
        }
    }
]
```

--------------------------------

### GET /v1/bookmarks/<id>

Source: https://kinoapi.com/api_bookmarks.html

Retrieves the list of movies/series in a specified folder. This is an alternative endpoint for backward compatibility.

```APIDOC
## [GET] /v1/bookmarks/<id>

### Description
Retrieves the list of movies/series in a specified folder. This is an alternative endpoint for backward compatibility.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/bookmarks/<id>

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the folder.

### Response
#### Success Response (200)
- **status** (integer) - Status code.
- **folder** (object) - Folder details.
  - **id** (integer) - Folder ID.
  - **title** (string) - Folder title.
  - **views** (integer) - Number of views.
  - **created** (integer) - Creation timestamp.
  - **updated** (integer) - Last update timestamp.
- **items** (array) - List of media items. See 'Список медиа' for item structure.

#### Response Example
```json
{
  "status": 200,
  "folder": {
    "id": 1,
    "title": "Семейные",
    "views": 10,
    "created": 12345667,
    "updated": 12345678
  },
  "items": []
}
```
```

--------------------------------

### GET /v1/bookmarks/get-item-folders?item=<id>

Source: https://kinoapi.com/api_bookmarks.html

Retrieves a list of folders that contain a specific movie or series item.

```APIDOC
## [GET] /v1/bookmarks/get-item-folders?item=<id>

### Description
Retrieves a list of folders that contain a specific movie or series item.

### Method
GET

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

### Parameters
#### Query Parameters
- **item** (integer) - Required - The ID of the movie or series item.

### Response
#### Success Response (200)
- **status** (integer) - Status code.
- **folders** (array) - List of folders.
  - **id** (integer) - Folder ID.
  - **title** (string) - Folder title.
  - **views** (integer) - Number of views.
  - **created** (integer) - Creation timestamp.
  - **updated** (integer) - Last update timestamp.

#### Response Example
```json
{
  "status": 200,
  "folders": [
    {
      "id": 1,
      "title": "Семейные",
      "views": 10,
      "created": 12345667,
      "updated": 12345678
    }
  ]
}
```
```

--------------------------------

### GET /v1/references/video-quality

Source: https://kinoapi.com/api_references.html

Returns the list of video qualities. The response includes an items array with objects containing id, title, and quality fields.

```http
GET https://api.service-kp.com/v1/references/video-quality

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

{
  'status': 200,
  'items': [
     {
        "id": 1,
        "title": "480p",
        "quality": 480,
     },
     {
        "id": 2,
        "title": "720p",
        "quality": 720,
     },
  ],
}
```

--------------------------------

### GET /v1/bookmarks/view?folder=<id>

Source: https://kinoapi.com/api_bookmarks.html

Retrieves the list of movies/series in a specified folder. Two request variants are provided for backward compatibility.

```APIDOC
## [GET] /v1/bookmarks/view?folder=<id>

### Description
Retrieves the list of movies/series in a specified folder. Two request variants are provided for backward compatibility.

### Method
GET

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

### Parameters
#### Query Parameters
- **folder** (integer) - Required - The ID of the folder.

### Response
#### Success Response (200)
- **status** (integer) - Status code.
- **folder** (object) - Folder details.
  - **id** (integer) - Folder ID.
  - **title** (string) - Folder title.
  - **views** (integer) - Number of views.
  - **created** (integer) - Creation timestamp.
  - **updated** (integer) - Last update timestamp.
- **items** (array) - List of media items. See 'Список медиа' for item structure.

#### Response Example
```json
{
  "status": 200,
  "folder": {
    "id": 1,
    "title": "Семейные",
    "views": 10,
    "created": 12345667,
    "updated": 12345678
  },
  "items": []
}
```
```

--------------------------------

### GET bookmarks/get-item-folders request

Source: https://kinoapi.com/api_bookmarks.html

Request to retrieve the list of folders that contain a specific item, identified by the 'item' query parameter.

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

--------------------------------

### POST /v1/bookmarks/create

Source: https://kinoapi.com/api_bookmarks.html

Creates a new bookmark folder with the specified title.

```APIDOC
## [POST] /v1/bookmarks/create

### Description
Creates a new bookmark folder with the specified title.

### Method
POST

### Endpoint
https://api.service-kp.com/v1/bookmarks/create

### Parameters
#### Request Body
- **title** (string) - Required - The name of the folder.

### Response
#### Success Response (200)
- **status** (integer) - Status code.
- **folder** (object) - The created folder.
  - **id** (integer) - Folder ID.
  - **title** (string) - Folder title.
  - **views** (integer) - Number of views.
  - **created** (integer) - Creation timestamp.
  - **updated** (integer) - Last update timestamp.

#### Response Example
```json
{
  "status": 200,
  "folder": {
    "id": 134,
    "title": "Название",
    "views": 10,
    "created": 12312334,
    "updated": 1231233123
  }
}
```
```

--------------------------------

### GET /v1/countries Response

Source: https://kinoapi.com/api_video.html

Example JSON response from the /v1/countries endpoint. Contains an array of country objects with 'id' and 'title' fields. Note the Content-Type header is shown as 'application/js' (likely a typo).

```http
HTTP/1.1 200 OK
Content-Type: application/js

[
    {
        'id': 1,
        'title': 'США',
    }
]
```

--------------------------------

### Response for creating a folder

Source: https://kinoapi.com/api_bookmarks.html

Example JSON response for the create folder endpoint, containing the created folder object with id, title, views, created, and updated fields.

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

[
    'status': 200,
    'folder': {
        'id': 134,
        'title': 'Название',
        'views': 10,
        'created': 12312334,
        'updated': 1231233123,
    }
]
```

--------------------------------

### GET /v1/device

Source: https://kinoapi.com/api_device.html

Получение списка устройств на аккаунте. Возвращает массив устройств с их идентификаторами, названиями, аппаратным и программным обеспечением, временем создания и обновления, а также настройками.

```APIDOC
## GET /v1/device

### Description
Получение списка устройств на аккаунте.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/device

### Response
#### Success Response (200)
- **status** (integer) - Статус ответа
- **devices** (array) - Список устройств
  - **id** (integer) - Идентификатор устройства
  - **title** (string) - Название устройства
  - **hardware** (string) - Аппаратное обеспечение
  - **software** (string) - Программное обеспечение
  - **created** (integer) - Время создания (Unix timestamp)
  - **updated** (integer) - Время обновления (Unix timestamp)
  - **last_seen** (integer) - Время последней активности (Unix timestamp)
  - **is_browser** (integer) - Флаг браузерного устройства
  - **settings** (object) - Список настроек

#### Response Example
```json
{
  "status": 200,
  "devices": [
    {
      "id": 1,
      "title": "AppleTV Hall",
      "hardware": "AppleTV/5.3",
      "software": "iOS/8.3",
      "created": 12345667,
      "updated": 12345678,
      "last_seen": 12345678,
      "is_browser": 0,
      "settings": {}
    }
  ]
}
```
```

--------------------------------

### Получение настроек устройства (GET /v1/device/123/settings)

Source: https://kinoapi.com/api_device.html

HTTP запрос для получения настроек устройства. Ответ содержит статус и объект settings с настройками. В примере показаны настройки useSsl, supportHevc, settingKey, serverLocation, streamingType. Статус 200 означает успех, 400 - ошибку.

```http
GET https://api.service-kp.com/v1/device/123/settings

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

 [
     'status': 200, // 400 если ошибка
     'settings': {
         'useSsl': {
            'label': 'Использовать SSL',
            'value': 1,
         },
         'supportHevc': {
            'label': 'Использовать SSL',
            'value': 1,
         },
         'settingKey': {
            'label': 'Setting label in UI',
            'value': 'setting value',
         },
         'serverLocation': {
            'type': 'list',
            'value': [
               {
                  'id': 1,
                  'label': 'Германия',
                  'description': '',
                  'selected': 1,
               }
            ],
         },
         'streamingType: {
            'type': 'list',
            'value': [
               {
                  'id': 1,
                  'label': 'HLS',
                  'description': '',
                  'selected': 1,
               }
            ],
         }
     },
 ]
```

--------------------------------

### Get current device info - GET /v1/device/info

Source: https://kinoapi.com/api_device.html

Retrieves information about the current device. The response includes the same device fields as the device info endpoint, plus an 'is_browser' flag.

```http
GET https://api.service-kp.com/v1/device/info
```

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

[
    'status': 200,
    'device': {
        'id': 1,
        'title': 'AppleTV Hall',
        'hardware': 'AppleTV/5.3',
        'software': 'iOS/8.3'
        'created': 12345667,
        'updated': 12345678,
        'last_seen': 12345678,
        'is_browser': 0,
        'settings: {
          // Список настроек
        }
    }
]
```

--------------------------------

### POST bookmarks/create request

Source: https://kinoapi.com/api_bookmarks.html

Request to create a new folder. Requires a 'title' parameter (folder name).

```http
POST https://api.service-kp.com/v1/bookmarks/create
```

--------------------------------

### Изменение настроек устройства (POST /v1/device/123/settings)

Source: https://kinoapi.com/api_device.html

HTTP запрос для изменения настроек устройства. В теле запроса передаются настройки в формате JSON, например, useSsl и support4k. Ответ содержит статус 200 при успехе.

```http
POST https://api.service-kp.com/v1/device/123/settings
{'useSsl': true, 'support4k': false }

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

 [
   'status': 200,
 ]
```

--------------------------------

### POST /v1/bookmarks/add

Source: https://kinoapi.com/api_bookmarks.html

Adds a movie to a specified folder.

```APIDOC
## POST /v1/bookmarks/add

### Description
Adds a movie to a specified folder.

### Method
POST

### Endpoint
https://api.service-kp.com/v1/bookmarks/add

### Parameters
#### Request Body
- **item** (string) - Required - Identifier of the movie.
- **folder** (string) - Required - Identifier of the folder.

### Response
#### Success Response (200)
- **status** (integer) - Status code.

#### Response Example
```json
{
  "status": 200
}
```
```

--------------------------------

### Формат настройки типа 'list' (serverLocation)

Source: https://kinoapi.com/api_device.html

Пример структуры настройки с типом 'list'. Показывает обязательные поля: id, label, description, selected. Используется для настроек, которые требуют выбора из списка, например, serverLocation.

```json
'serverLocation': {
   'type': 'list',
   'value': [
      {
         'id': 1,
         'label': 'Германия',
         'description': '',
         'selected': 1,
      }
   ],
},
```

--------------------------------

### GET /v1/countries Request

Source: https://kinoapi.com/api_video.html

Request to retrieve the list of countries.

```http
GET https://api.service-kp.com/v1/countries
```

--------------------------------

### GET /v1/bookmarks - List bookmark folders

Source: https://kinoapi.com/api_bookmarks.html

Request to list all bookmark folders. Returns a JSON response with status 200 and an items array containing folder details such as id, title, views, count, created, and updated.

```http
GET https://api.service-kp.com/v1/bookmarks
```

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

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

--------------------------------

### GET trailer request

Source: https://kinoapi.com/api_video.html

Request a trailer by providing either an 'id' or 'sid' parameter.

```http
GET https://api.service-kp.com/v1/items/trailer?[id=123 | sid=l_5JsdfkjN34]
```

--------------------------------

### Ответ API: информация о просмотрах (сериалы и фильмы)

Source: https://kinoapi.com/api_watching.html

Пример ответа API на запрос информации о просмотрах. Содержит структуру данных для сериалов (seasons) и для фильмов (videos). Поля status, time, updated описывают состояние просмотра.

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

[
    'status' => 200,
    'item' => {
        'id' => 123,
        'title' => 'Item title',
        'type' => 'serial',

        // В зависимости от типа контента данная часть может меняться
        // Для сериалов
        'seasons' => [
            {
                'id': 432,
                'number': 1,
                'status': -1, // Статус просмотра сезона: -1 не смотрели вообще, 0 - начали смотреть, 1 - просмотрели
                'episodes': [
                    {
                        'id': 4567,
                        'number': 1,
                        'title': 'Episode title',
                        'duration': 1234, // Длительность видео в секундах
                        'time': 0, // На которой секунде остановлен просмотр
                        'status': -1, // Статус просмотра эпизода: -1 не смотрели вообще, 0 - начали смотреть, 1 - просмотрели
                        'updated': 123456782 // timestamp, Когда последний раз просматривали эпизод
                    }
                ]
            }
        ]

        // Для фильмов, многосерийных фильмов и тд
        'videos': [
            {
                'id': 1234,
                'number': 1,
                'title': 'Episode title',
                'duration': 1234, // Длительность видео в секундах
                'time': 123, // На которой секунде остановлен просмотр
                'status': 1, // Статус просмотра эпизода: -1 не смотрели вообще, 0 - начали смотреть, 1 - просмотрели
                'updated': 123456782 // timestamp, Когда последний раз просматривали эпизод
            },
        ]
    }
]
```

--------------------------------

### GET /v1/items/comments

Source: https://kinoapi.com/api_video.html

Fetches comments for a specific movie, series, or episode identified by its item ID.

```APIDOC
## [GET] /v1/items/comments

### Description
Fetches comments for a specific movie, series, or episode identified by its item ID.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/items/comments

### Parameters
#### Query Parameters
- **id** (integer) - Required - Identifier of the movie/series/etc

### Request Example
GET https://api.service-kp.com/v1/items/comments?id=<item_id>

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code
- **item** (object) - Item information
  - **id** (integer) - Item ID
  - **title** (string) - Item title
- **comments** (array) - List of comments
  - **id** (integer) - Comment ID
  - **depth** (integer) - Comment depth level
  - **unread** (boolean) - Whether the comment is unread
  - **deleted** (boolean) - Whether the comment is deleted
  - **message** (string) - Comment text
  - **created** (integer) - Creation timestamp
  - **rating** (string) - Comment rating
  - **user** (object) - User information
    - **id** (integer) - User ID
    - **name** (string) - User name
    - **avatar** (string) - User avatar URL

#### Response Example
{
    "status":200,
    "item" : {
        "id":1235,
        "title":"Книга крови /  Book of Blood"
    },
    "comments":[
       {
           "id":1,
           "depth":0,
           "unread":false,
           "deleted":false,
           "message":"comment message",
           "created":1234234234,
           "rating":"0",
           "user":{
               "id":123,
               "name":"UserName",
               "avatar":"http://gravatar.com/avatar/asdasdasdas"
            }
        }
     ]
}
```

--------------------------------

### GET /v1/device/{deviceId}/settings

Source: https://kinoapi.com/api_device.html

Retrieves the current settings for a specific device. The response includes a status code and a settings object containing key-value pairs for each setting, where list-type settings include an array of options with id, label, description, and selected fields.

```APIDOC
## GET /v1/device/{deviceId}/settings

### Description
Retrieves the current settings for a specific device. The response includes a status code and a settings object containing key-value pairs for each setting, where list-type settings include an array of options with id, label, description, and selected fields.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/device/{deviceId}/settings

### Parameters
#### Path Parameters
- **deviceId** (integer) - Required - The unique identifier of the device.

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code (200 on success, 400 on error).
- **settings** (object) - Object containing device settings. Each key is a setting name, and the value is either a boolean/integer/string for checkbox-type settings, or an object with `type: 'list'` and a `value` array for list-type settings.
  - **useSsl** (object) - Example checkbox setting with `label` and `value` fields.
  - **supportHevc** (object) - Example checkbox setting with `label` and `value` fields.
  - **settingKey** (object) - Generic setting with `label` and `value` fields.
  - **serverLocation** (object) - List-type setting with `type: 'list'` and a `value` array containing objects with `id`, `label`, `description`, and `selected` fields.
  - **streamingType** (object) - List-type setting with `type: 'list'` and a `value` array containing objects with `id`, `label`, `description`, and `selected` fields.

#### Response Example
```json
[
    'status': 200,
    'settings': {
        'useSsl': {
            'label': 'Использовать SSL',
            'value': 1,
        },
        'supportHevc': {
            'label': 'Использовать SSL',
            'value': 1,
        },
        'settingKey': {
            'label': 'Setting label in UI',
            'value': 'setting value',
        },
        'serverLocation': {
            'type': 'list',
            'value': [
                {
                    'id': 1,
                    'label': 'Германия',
                    'description': '',
                    'selected': 1,
                }
            ],
        },
        'streamingType': {
            'type': 'list',
            'value': [
                {
                    'id': 1,
                    'label': 'HLS',
                    'description': '',
                    'selected': 1,
                }
            ],
        }
    },
]
```

```

--------------------------------

### GET /v1/watching/togglewatchlist

Source: https://kinoapi.com/api_watching.html

Adds a series to the 'Will watch' list or removes it. Requires the id parameter.

```APIDOC
## GET /v1/watching/togglewatchlist

### Description
Adds a series to the 'Will watch' list or removes it.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/watching/togglewatchlist

### Parameters
#### Query Parameters
- **id** (string) - Required - Identifier of the series.

### Request Example
GET https://api.service-kp.com/v1/watching/togglewatchlist?id=123

### Response
#### Success Response (200)
- **status** (integer) - Status code, always 200.
- **watching** (boolean) - true if marked as watched, false if marked as unwatched.

#### Response Example
HTTP/1.1 200 OK
Content-Type: application/json

[
    'status' => 200,
    'watching' => true // false - marked as unwatched, true - marked as watched
]
```

--------------------------------

### GET /v1/watching/movies - запрос и ответ

Source: https://kinoapi.com/api_watching.html

Запрос для получения списка недосмотренных фильмов, концертов, документальных фильмов и 3D. Ответ содержит статус и массив items с информацией о каждом элементе.

```http
GET https://api.service-kp.com/v1/watching/movies
```

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

[
    'status' => 200,
    'items' => [
        {
            'id': 123,
            'type': 'movie',
            'subtype': '', // если многосерийный фильм - multi
            'title': 'Название',
            'posters': [
                'small': 'http://url.to/small_poster.jpg',
                'medium': 'http://url.to/medium_poster.jpg',
                'big': 'http://url.to/big_poster.jpg',
            ]
        }
    ],
]
```

--------------------------------

### GET /v1/watching/movies

Source: https://kinoapi.com/api_watching.html

Retrieves a list of unwatched movies, concerts, documentaries, and 3D content for the user.

```APIDOC
## GET /v1/watching/movies

### Description
Retrieves a list of unwatched movies, concerts, documentaries, and 3D content for the user.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/watching/movies

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code
- **items** (array) - List of items
  - **id** (integer) - Item ID
  - **type** (string) - Type of content (e.g., 'movie')
  - **subtype** (string) - Subtype, 'multi' for multi-episode films
  - **title** (string) - Title of the content
  - **posters** (object) - Poster URLs
    - **small** (string) - URL to small poster
    - **medium** (string) - URL to medium poster
    - **big** (string) - URL to big poster

#### Response Example
```json
{
    "status": 200,
    "items": [
        {
            "id": 123,
            "type": "movie",
            "subtype": "",
            "title": "Название",
            "posters": {
                "small": "http://url.to/small_poster.jpg",
                "medium": "http://url.to/medium_poster.jpg",
                "big": "http://url.to/big_poster.jpg"
            }
        }
    ]
}
```
```

--------------------------------

### GET /v1/references/voiceover-author

Source: https://kinoapi.com/api_references.html

Retrieves the list of voiceover authors. Returns an array of items with id, title, and short_title.

```APIDOC
## GET /v1/references/voiceover-author

### Description
Retrieves the list of voiceover authors.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/references/voiceover-author

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code
- **items** (array) - List of voiceover authors
  - **id** (integer) - Unique identifier
  - **title** (string) - Author title (e.g., 'Видеосервис')
  - **short_title** (string or null) - Short title (e.g., null)

#### Response Example
{
  "status": 200,
  "items": [
    {
      "id": 1,
      "title": "Видеосервис",
      "short_title": null
    }
  ]
}
```

--------------------------------

### Запрос GET для получения медиа-ссылок

Source: https://kinoapi.com/api_video.html

Отправляет GET-запрос к API для получения ссылок на видео и субтитры. Параметр mid обязателен и указывает идентификатор media.

```http
GET https://api.service-kp.com/v1/items/media-links?mid=<media_id>
```

--------------------------------

### GET /v1/references/voiceover-type

Source: https://kinoapi.com/api_references.html

Retrieves the list of voiceover types. Returns an array of items with id, title, and short_title.

```APIDOC
## GET /v1/references/voiceover-type

### Description
Retrieves the list of voiceover types.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/references/voiceover-type

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code
- **items** (array) - List of voiceover types
  - **id** (integer) - Unique identifier
  - **title** (string) - Full title (e.g., 'Дубляж')
  - **short_title** (string or null) - Short title (e.g., 'DUB')

#### Response Example
{
  "status": 200,
  "items": [
    {
      "id": 1,
      "title": "Дубляж",
      "short_title": "DUB"
    }
  ]
}
```

--------------------------------

### GET /v1/items/popular

Source: https://kinoapi.com/api_video.html

Retrieves a list of popular video content. Supports pagination and filtering by content type.

```APIDOC
## GET /v1/items/popular

### Description
Retrieves a list of popular video content. Supports pagination and filtering by content type.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/items/popular

### Parameters
#### Query Parameters
- **type** (string) - Required - Type of video content (see content types)
- **page** (integer) - Optional - Current page number (default: 0)
- **perpage** (integer) - Optional - Number of items per page (default: 25)

### Response
#### Success Response (200)
- **Video content** - The response contains video content as described in the Video Content section.

#### Response Example
(No explicit example provided in source)

```

--------------------------------

### GET /v1/items/hot

Source: https://kinoapi.com/api_video.html

Retrieves a list of hot video content. Supports pagination and filtering by content type.

```APIDOC
## GET /v1/items/hot

### Description
Retrieves a list of hot video content. Supports pagination and filtering by content type.

### Method
GET

### Endpoint
https://api.service-kp.com/v1/items/hot

### Parameters
#### Query Parameters
- **type** (string) - Required - Type of video content (see content types)
- **page** (integer) - Optional - Current page number (default: 0)
- **perpage** (integer) - Optional - Number of items per page (default: 25)

### Response
#### Success Response
Returns a list of video content items (see Video Content section).
```