Skip to content
Last updated

Manage live stream sources

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:

Example request
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:

Example response
{
  "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:

Example request
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:

Example response
{
  "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).

Example request
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:

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

Remove a live stream source

Delete a live stream source (publisher) named myRTMPencoder:

Example request
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