live sources query examples

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:

Wowza Streaming Engine 4.3.0 or later is required.

PHP examples for the tasks in this article are available in the tests folder of the PHP REST Library for Wowza Streaming Engine on GitHub.

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