Skip to content

Flussonic Media Server API

The Flussonic Media Server API Reference lets you manage the server configuration:

  • retrieve the information about streams, DVRs, templates, and so on
  • create/update, and remove streams, DVRs, templates, and so on
  • monitor system performance (performance metrics, statuses of peers)
  • configure cluster features (loadbalancers, cluster_ingest)
  • manage subscribers and packages for the IPTV plugin
  • configure physical devices (DVB cards, SDI cards)
  • manage listeners and other global configurations

Flussonic Media Server API Reference provides you with all the methods, fields, possible values, and endpoints available in Flussonic.

Warning

Do not manage streams with the Flussonic API and config_external simultaneously. For example, if you try to run the PUT /streamer/api/v3/streams/{name} with config_external enabled, Flussonic returns HTTP 400 error.

Authorizing API calls

To make API calls, use either Basic Auth or Bearer Token authorization scheme. In both cases you need to generate a token — a base64-encoded username and password string from the edit_auth.

To generate the token, run the following command in the terminal:


echo -n "username:password" | base64 -w 0

The output will look like so:


bG9naW46cGFzc3dvcmQ=

Use the generated token to make API calls with Basic Auth:


curl -v --request POST 'http://localhost/flussonic/api/v3/streams/bunny/stop' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic bG9naW46cGFzc3dvcmQ='

or Bearer Token:


curl -v --request POST 'http://localhost/flussonic/api/v3/streams/bunny/stop' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bG9naW46cGFzc3dvcmQ='