Skip to content

Streaming API explanation

General information

Flussonic provides a special Streaming API (see public reference) that allows you to build your own player or another application with all playing possibilities available in Flussonic Media Server.

The methods provided by this API are essentially the URLs that can be accessed by a player for playing video streams and files by various protocols (for details, see the Video Playback chapter).

Additionally to playing streams and files, with Streaming API you can:

  • publish streams via some protocols;
  • manage images during playback (generate thumbnails, get the logo image);
  • get information about media content and DVR recording status of played streams.

Authorization

Streaming API works in a context of a playback session with a token of a viewer. The token is inserted in the query string just as described in the Authorization chapter.

It is possible to use external authorization via the authorization backend.

Examples of API requests

Here is the example of API request for getting HLS master playlist using the Streaming-API: GET /{name}/index.m3u8 method:

curl http://FLUSSONIC-IP:8080/stream1/index.m3u8?token=60334b207baa

To play the stream, you should pass this link to an HLS player like STB, mobile application, or web application.

Here is the example of API request for getting a JPEG thumbnail from DVR archive using the Streaming-API: GET /{name}/{from}-preview.jpg method:

curl http://FLUSSONIC-IP:8080/stream1/1650864271-preview.jpg?token=60334b207baa