Authorization

To authenticate user requests to the API, we use a token with the transfer of an access key. To receive the key, register in your personal account.

For cURL requests, you can provide an access token via bearer auth:

-H 'Authorization: Bearer $API_KEY'

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

To add video

Videos can be uploaded in several ways:

  1. Through the control panel interface (Upload button on the top right)
  2. Through the API after successful authorization
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'

To upload your poster, you need to add the header X-Poster-URL and specify the external URL.

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

  1. Through the download widget, which you can place on your website

Upload widget example: https://dashboard.kinescope.io/assets/uploader/

Examples of video uploading

Listing all your videos

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

Getting video info