Create and manage live sources by using the Wowza Streaming Engine REST API

Use the Wowza Streaming Engine™ media server software REST API to create and manage encoders and cameras that publish live streams.

Notes:

Get a list of live stream sources


View a list of the live stream sources (publishers) connected to a local instance of Wowza Streaming Engine:

curl -X GET \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers

The command should return a response that looks like this:

{
  "serverName": "serverName",
  "publishers": [{
      "publisher": "myRTSPcamera"
  }]
}

Create a live stream source


Create a live stream source (publisher) for a local instance of Wowza Streaming Engine named myRTMPencoder:

curl -X POST \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers \
-d'
{
  "password": "123",
  "publisher": "myRTMPencoder",
  "serverName": "",
  "description": "",
  "version": "3"
}'

The command should return a response that looks like this:

{
  "success": true,
  "message": "",
  "data": null
}

Update a live stream source


Update a live stream source (publisher) named myRTMPencoder for a local instance of Wowza Streaming Engine:

Note: You'll replace myRTMPencoder with the name of your live stream source (publisher).
curl -X PUT \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers/myRTMPencoder \
-d'
{
  "password": "newpassword",
  "publisher": "publisher",
  "serverName": "",
  "description": "",
  "version": "3"
}'

The command should return a response that looks like this:

{
  "success": true,
  "message": "publisher updated",
  "data": null
}

Remove a live stream source


Delete a live stream source (publisher) named myRTMPencoder:

curl -X DELETE \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers/myRTMPencoder