Авторизация

Для аутентификации запросов пользователей к API мы используем токен с передачей ключа доступа. Для получения ключа зарегистрируйтесь в личном кабинете.

Для запросов cURL вы можете предоставить токен доступа через bearer auth:

-H 'Authorization: Bearer $API_KEY'

curl <https://api.kinescope.io/v1/videos> \\
-H 'Authorization: Bearer $API_KEY'

Добавление видео

Видео можно загрузить несколькими способами:

1. Через интерфейс панели управления (кнопка Загрузить справа вверху)

2. Через API после успешной авторизации

   curl -XPOST '<https://uploader.kinescope.io/video>' \\
   -H 'X-Video-Title: Video title' \\
   -H 'X-Video-Description: Video description' \\
   -H 'X-File-Name: video.mp4' \\
   -H 'Authorization: Bearer $API_KEY' \\
   --data-binary '@/full/path/to/video/file.mp4'
   

   Для загрузки своего постера нужно добавить заголовок X-Poster-URL и указать внешний URL.

   Upload video from external url use header X-Video-URL (-H 'X-Video-URL: [<http://example.ru/video.mp4>](<http://example.ru/video.mp4>)')

Примеры загрузки видео

Получение списка видео

curl <https://api.kinescope.io/v1/videos?page=1&per_page=25> \\
-H 'Authorization: Bearer $API_KEY'

Получение информации о видео

curl <https://api.kinescope.io/v1/videos/$VIDEO_ID> \\
-header 'Authorization: Bearer $API_KEY'

В структуре Video возвращается вся информация, в том числе ссылка на манифест hls_link, ссылка для проигрывания play_link, и ссылка встраивания embed_link

Обновление информации о видео

curl -XPATCH <https://api.kinescope.io/v1/videos/$VIDEO_ID> \\
--header 'Authorization: Bearer $API_KEY' \\
--header 'Content-Type: application/json' \\
--data-raw '{
    "title": "New title",
    "description": "New description",
    "privacy_type": "custom",
    "privacy_domains": ["my_domain.io"],
    "additional_materials_enabled": false,
		"subtitles_enabled": true,
}'