api.video is an API that encodes on the go to facilitate immediate playback, enhancing viewer streaming experiences across multiple devices and platforms. You can stream live or on-demand online videos within minutes.

api.video NodeJS SDK

DEPRECATION WARNING: this SDK will soon be deprecated and will no longer be maintained. It has been replaced by the NodeJS API client. Please use it instead.

The api.video web-service helps you put video on the web without the hassle. This documentation helps you use the corresponding NodeJS client.

Installation

npm install @api.video/nodejs-sdk

Usage

const apiVideo = require('@api.video/nodejs-sdk');

(async () => {
  try {
    // Create client for Production and authenticate
    const client = new apiVideo.Client({ apiKey: 'xxx' });

    // Create and upload a video ressource
    const video = await client.videos.upload('test/data/small.webm', { title: 'Course #4 - Part B' });
    console.log(video);
  } catch (e) {
    console.error(e);
  }
})();

See sandbox.spec.js for more usage examples.

Full API

/**
 * VIDEO
 */
const client = new apiVideo.Client({ apiKey: 'xxx' });

// Show a video
client.videos.get(videoId);

// Show a video status
client.videos.getStatus(videoId);

// List or search videos
client.videos.search(parameters = {});

// Create video properties
client.videos.create(title, properties = {});

// Upload a video media file
// Create a video, if videoId is null
client.videos.upload(source, properties = {}, videoId = null);

// Create a video by downloading it from a third party
client.videos.download(source, title, properties = {});

// Update video properties
client.videos.update(videoId, properties);

// Set video public
client.videos.makePublic(videoId);

// Set video private
client.videos.makePrivate(videoId);

// Delete video (file and data)
client.videos.delete(videoId);

// Delegated upload (generate a token for someone to upload a video into your account)
result = client.tokens.generate(); // string(3): "xyz"
result.then(function(token) {
  // ...then upload from anywhere without authentication:
  //  curl https://ws.api.video/upload?token=xyz -F [email protected]
});

/**
 * VIDEO THUMBNAIL
 */
// Upload a thumbnail for video
client.videos.uploadThumbnail(source, videoId);

// Update video's thumbnail by picking timecode
client.videos.updateThumbnailWithTimecode(videoId, timecode);

/**
 * VIDEO CAPTIONS
 */
// Get caption for a video
client.videos.captions.get(videoId, language);

// Get all captions for a video
client.videos.captions.getAll(videoId);

// Upload a caption file for a video (.vtt)
client.videos.captions.upload(source, properties);


// Set default caption for a video
client.videos.captions.updateDefault(videoId, language, isDefault);

// Delete video's caption
client.videos.captions.delete(videoId, language);

/**
 * VIDEO CHAPTERS
 */
// Get caption for a video
client.videos.chapters.get(videoId, language);

// Get all chapters for a video
client.videos.chapters.getAll(videoId);

// Upload a chapter file for a video (.vtt)
client.videos.chapters.upload(source, properties);

// Delete video's chapter
client.videos.chapters.delete(videoId, language);

/**
 * PLAYERS
 */
// Get a player
client.players.get(playerId);

// List players
client.players.search(parameters = {});

// Create a player
client.players.create(properties = {});

// Update player's properties
client.players.uploadLogo(source, playerId, link);

// Update player's properties
client.players.update(playerId, properties);

// Delete a player logo
client.players.deleteLogo(playerId);

// Delete a player
client.players.delete(playerId);

/**
 * LIVE
 */
// Show a live
client.lives.get(liveStreamId);

// List or search lives
client.lives.search(parameters = {});

// Create live properties
client.lives.create(name, properties = {});

// Update live properties
client.lives.update(liveStreamId, properties);

// Delete live (file and data)
client.lives.delete(liveStreamId);

/**
 * LIVE THUMBNAIL
 */
// Upload a thumbnail for live
client.lives.uploadThumbnail(source, liveStreamId);

/**
 * ANALYTICS
 */
// Get video analytics between period
client.analyticsVideo.get(videoId, period);

// Get live analytics between period
client.analyticsLive.get(liveStreamId, period);

// Get analytics session events
client.analyticsLive.get(sessionId, parameters);

Full API Details Implementation

Videos

| Function | Parameters | Description | Required | Allowed Values |
| :---------------------------------: | :-------------------: | :------------------------: | :--------------------: | :--------------------- | | get | videoId(string) | Video identifier | :heavy_check_mark: | - | | getStatus | videoId(string) | Video identifier | :heavy_check_mark: | - | | search | - | - | - | - | | - | parameters(object) | Search parameters | :x: |

• currentPage(int)
• pageSize(int)
• sortBy(string)
• sortOrder(string)
• keyword(string)
• tags(string|array(string))
• metadata(array(string))

• description(string)
• tags(array(string))
• playerId(string)
• metadata(array(
  array(
  'key' => 'Key1',
  'value' => 'value1'
  ),
  array(
  'key' => 'Key2',
  'value' => 'value2'
  )
  )
• panoramic(bool)
• public(bool)
• mp4Support(bool)

• title(string)
• description(string)
• tags(array(string))
• playerId(string)
• metadata(array(
  array(
  'key' => 'Key1',
  'value' => 'value1'
  ),
  array(
  'key' => 'Key2',
  'value' => 'value2'
  )
  )

• title(string)
• description(string)
• tags(array(string))
• playerId(string)
• metadata(array(
  array(
  'key' => 'Key1',
  'value' => 'value1'
  ),
  array(
  'key' => 'Key2',
  'value' => 'value2'
  )
  )
• panoramic(bool)
• public(bool)
• mp4Support(bool)

Players

Captions

Chapters

Lives

| Function | Parameters | Description | Required | Allowed Values |
| :---------------------------------: | :-------------------: | :------------------------: | :--------------------: | :--------------------- | | get | liveStreamId(string) | Live identifier | :heavy_check_mark: | - | | search | - | - | - | - | | - | parameters(object) | Search parameters | :x: |

• currentPage(int)
• pageSize(int)
• sortBy(string)
• sortOrder(string)

• record(boolean)
• playerId(string)

• name(string)
• record(boolean)
• playerId(string)

AnalyticsVideo

| Function | Parameters | Description | Required | Allowed Values/Format |
| :---------------------------------: | :-------------------: | :------------------------: | :--------------------: | :--------------------- | | get | - | - | - | - | | - | videoId(string) | Video identifier | :heavy_check_mark: | - | | - | period (string) | Period research | :x: |

• For a day : 2018-01-01
• For a week: 2018-W01
• For a month: 2018-01
• For a year: 2018
• Date range: 2018-01-01/2018-01-15
|

AnalyticsLive

| Function | Parameters | Description | Required | Allowed Values/Format |
| :---------------------------------: | :-------------------: | :------------------------: | :--------------------: | :--------------------- | | get | - | - | - | - | | - | liveStreamId(string) | Live identifier | :heavy_check_mark: | - | | - | period (string) | Period research | :x: |

• For a day : 2018-01-01
• For a week: 2018-W01
• For a month: 2018-01
• For a year: 2018
• Date range: 2018-01-01/2018-01-15
|

AnalyticsSessionEvent

| Function | Parameters | Description | Required | Allowed Values/Format |
| :---------------------------------: | :-------------------: | :------------------------: | :--------------------: | :--------------------- | | get | - | - | - | - | | - | sessionId(string) | Session identifier | :heavy_check_mark: | - | | - | parameters(array) | Search parameters | :x: |

• currentPage(int)
• pageSize(int)
|

Tokens

| Function | Parameters | Description | Required | Allowed Values |
| :---------------------------------: | :-------------------: | :------------------------: | :--------------------: | :--------------------- | | generate | - | Token for delegated upload | - | - |

Account

| Function | Parameters | Description | Required | Allowed Values |
| :---------------------------------: | :-------------------: | :------------------------: | :--------------------: | :--------------------- | | get | - | Get account informations (quota, features) | - | - |

More on api.video

A full technical documentation is available on https://docs.api.video/

Test

npm run test

You can also run a bunch of commands against your actual sandbox:

API_KEY=xxx npm run test:sandbox

Use the Sandbox API Key and not your production key.