API Reference - Non-Interactive Live Streaming

This page describes the API references for Non-Inteactive (Direct Ingestion) Live Streaming

---

Table of Contents

1. Generate JWT Token

2. Start Live Streaming

3. Get Live Viewers Count

4. Get Live Viewers Count for Low Latency Live Streaming

---

1. Generate JWT Token

Generate JWT Token to use with sariska services

post

/api/v1/misc/generate-token

Body

apiKeystring

please pass apiKey with tied with your sariska account

Example: iufwenufewifweifiuTbddhbdjhjfbjfjwfjwfj

expstring

pass exp claim of jwt token

Example: 24 hours

nbfstring

pass nbf claim of jwt token

Example:

scopestring

pass scope of token it can be messaging or media or sariska or leave it blank

Example:

userobject

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.sariska.io/api/v1/misc/generate-token' \
  --header 'Content-Type: application/json'

200

401

200

{
  "token": "text"
}

A successfully generated response for jwt token

1. Start Live Streaming (Direct Ingestion)

Starts new live streaming

post

/terraform/v1/hooks/srs/startRecording

Authorizations

Body

is_low_latencyboolean

Whether the live streaming needs to be in low latency

Example: true

is_direct_ingestionboolean

Instead of a room, we use direct ingestion to start a live stream, for e.g. from obs

Example: true

multi_bitrateboolean

If true is passed, the stream will be transcoded into 5 different variants: 720p (HD), 480p (HD_MID), 360p (MID), 240p (MID_LOW), and 240p (LOW) with bitrates of 2628kbps, 1128kbps, 878kbps, 528kbps, and 264kbps, respectively. This will ensure the best possible viewing experience, regardless of the user's network or device.

Example: true

is_vodboolean

Please set this flag to true if you want to access the Video on Demand (VOD) URL. The VOD will be available after the live streaming has finished.

Example: true

Responses

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.sariska.io/terraform/v1/hooks/srs/startRecording' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"is_low_latency":true,"is_direct_ingestion":true,"multi_bitrate":true,"is_vod":true}'

200

400

401

422

502

504

200

{
  "started": true,
  "stream_path": "text",
  "srt_ingest_url": "text",
  "flv_ingest_url": "text",
  "rtmp_ingest_url": "text",
  "flv_play_url": "http://streaming-edge-nlb-tcp-bbc5ae3a0d2cb7a3.elb.ap-south-1.amazonaws.com:8080/4zrurnrwrvxxj8xf/wsb3vhnlxcrtdluw.flv?domain=ll_latency_h264",
  "rtmp_play_url": "rtmp://streaming-edge-nlb-tcp-bbc5ae3a0d2cb7a3.elb.ap-south-1.amazonaws.com:1935/4zrurnrwrvxxj8xf/wsb3vhnlxcrtdluw?domain=ll_latency_h264",
  "low_latency_hls_url": "https://low-latency-edge.sariska.io/original/4zrurnrwrvxxj8xf/wsb3vhnlxcrtdluw/playlist.m3u8",
  "hls_url": "https://edge.sariska.io/play/hls/2imjtqyu4udy4ol8/82e28qet2noruyzb.m3u8"
}

A generated response after live streaming started successfully

1. Get Live Viewers Count

Get all live viewers count

get

/terraform/v1/hooks/srs/live/viewers/count/{stream_name}

Path parameters

stream_namestringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.sariska.io/terraform/v1/hooks/srs/live/viewers/count/{stream_name}'

200

200

{
  "{stream_name}": {
    "current_viewers": 1,
    "uptime": 1
  }
}

A generated response for fetching live hls users count

1. Get Live Viewers Count for Low Latency HLS

Get all live viewers count with low latency HLS URL

get

/llhls/v1/hooks/srs/live/viewers/count/{stream_name}

Path parameters

stream_namestringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.sariska.io/llhls/v1/hooks/srs/live/viewers/count/{stream_name}'

200

200

{
  "{stream_name}": {
    "current_viewers": 1,
    "uptime": 1
  }
}

A generated response for fetching live hls users count