Skip to main content
Version: /v2

API Reference

VideoSDK provides REST APIs for RealTime Communication, which includes APIs for Rooms, Sessions, Recordings, RTMP and HLS.



BASE URL

https://api.videosdk.live



Authentication

The VideoSDK API uses access token to authenticate api requests. In REST APIs, token will be passed in a header field called `Authorization`.

In order to generate authentication token, you will need API_KEY and SECRET, which you can get them from here.

In payload, you have to add your apikey, permissions, version and role.

If you are concerned with security and want to generate token only for v2 API access, then you need to provide version and role.

  • apikey(Mandatory): You can get it from here.

  • permissions(Mandatory): Based on provided permission, participant will join the meeting accordingly.

    Available permissions are:

    • allow_join: The participant is allowed to join the meeting directly.
    • ask_join: The participant requires to ask for permission to join the meeting.
    • allow_mod: The participant is allowed to toggle webcam & mic of other participants.
  • version(optional): For accessing the v2 API, you need to provide 2 as the version value.

  • roles(optional):

    • CRAWLER: This role is only for accessing v2 API, you can not use this token for running the Meeting/Room.

Then, you will sign this payload with your SECRETand jwt options.



TOKEN GENERATION
const jwt = require('jsonwebtoken');
const API_KEY = <YOUR API KEY>;
const SECRET = <YOUR SECRET>;
const options = {
expiresIn: '10m',
algorithm: 'HS256'
};
const payload = {
apikey: API_KEY,
permissions: [`allow_join`], // `ask_join` || `allow_mod`
version: 2,
roles: ['CRAWLER'],
};
const token = jwt.sign(payload, SECRET, options);
console.log(token);

Room

To communicate or interact with others in audio or video call, you need `Room` for that. You can `create`, `validate` and `fetch` Rooms using Room APIs.

Session

Session refers to a single instance of a meeting. If you take multiple meetings with same `roomId`, then multiple session is created for that partcular roomId. With this API endpoints you can access details of sessions and its participants.

Recordings

This Recording APIs will allow you to start / stop / fetch / delete meeting recordings.

RTMP OUT

This RTMP OUT APIs will allow you to start / stop RTMP stream of meeting.

HLS Live Stream

This HLS Live Stream APIs will allow you to start / stop / fetch HLS stream of meeting.