Operations related to stream sources. You can create a Wowza stream source and associate it to a live stream or transcoder.
When you set up a Wowza stream source with a live stream or transcoder, Wowza Video can automatically detect broadcast location, automatically start a stream when the video source starts, and automatically stop a stream after the video source disconnects.
This operation shows limited details for all of your stream sources. For detailed information, fetch a single stream source of the appropriate type.
| filter | string Restricts the data that gets returned by filtering on one or more values associated with a field. Construct a filter using a two-part expression that specifies the field on which to filter and the logic to use to filter. Filters use a zero-based index. For valid filter operators and filter fields, see How to get filtered query results with the Wowza Video REST API. Example: filter[0][field]=state&filter[0][eq]=stopped |
| page | integer Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. For more information and examples, see Get paginated query results with the Wowza Video REST API. |
| per_page | integer For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000. |
Success
Unauthorized
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.11/stream_sources"
{- "stream_sources": [
- {
- "id": "cJYndjJt",
- "name": "My region-based Stream Source",
- "type": "wowza",
- "created_at": "2020-01-29T17:16:22.000Z",
- "updated_at": "2020-01-31T02:37:48.000Z"
}, - {
- "id": "pvVWPLZC",
- "name": "My IP address based Stream Source",
- "type": "wowza",
- "created_at": "2020-01-28T17:16:22.000Z",
- "updated_at": "2020-01-30T14:13:07.000Z"
}
]
}(Available from version 1.4) This operation creates a Wowza stream source. A Wowza stream source enables automatic transcoder start, stop, and broadcast location detection.
Success
required | object (stream_source_wowza) | ||||||||||||||
| |||||||||||||||
Unauthorized
Unprocessable Entity
{- "stream_source_wowza": {
- "name": "My Wowza Stream Source"
}
}{- "stream_source_wowza": {
- "created_at": "2020-01-29T17:16:22.001Z",
- "id": "brcndjJt",
- "name": "My Wowza Stream Source",
- "primary_url": "rtmp://origin.cdn.wowza.com:1935/live",
- "state": "stopped",
- "stream_name": "0I3abc1FPZ2P3Qxdfz3YwKtZdDqu6102",
- "updated_at": "2020-01-31T07:32:43.001Z"
}
}(Available from version 1.4) This operation shows limited details for all of your Wowza stream sources. A Wowza stream source enables automatic transcoder start, stop, and broadcast location detection. For detailed information, fetch a single Wowza stream source.
| page | integer Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. For more information and examples, see Get paginated query results with the Wowza Video REST API. |
| per_page | integer For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000. |
Success
required | Array of objects (stream_sources_wowza) | ||||||||
Array
| |||||||||
Unauthorized
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.11/stream_sources/wowza"
{- "stream_sources_wowza": [
- {
- "created_at": "2020-01-29T17:16:22.001Z",
- "id": "cJYndjJt",
- "name": "My Wowza Stream Source",
- "updated_at": "2020-01-30T19:44:59.001Z"
}, - {
- "created_at": "2020-01-28T17:16:22.001Z",
- "id": "pvVWPLZC",
- "name": "My other Wowza Stream Source",
- "updated_at": "2020-01-31T01:17:45.001Z"
}
]
}(Available from version 1.4) This operation shows details of a specific Wowza stream source. A Wowza stream source enables automatic transcoder start, stop, and broadcast location detection.
Success
required | object (stream_source_wowza) | ||||||||||||||
| |||||||||||||||
Unauthorized
Forbidden
Not Found
Gone
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.11/stream_sources/wowza/2adffc17"
{- "stream_source_wowza": {
- "created_at": "2020-01-29T17:16:22.001Z",
- "id": "brcndjJt",
- "name": "My Wowza Stream Source",
- "primary_url": "rtmp://origin.cdn.wowza.com:1935/live",
- "state": "stopped",
- "stream_name": "0I3abc1FPZ2P3Qxdfz3YwKtZdDqu6102",
- "updated_at": "2020-01-31T07:32:43.001Z"
}
}(Available from version 1.4) This operation updates a Wowza stream source. A Wowza stream source enables automatic transcoder start, stop, and broadcast location detection.
Provide the details of the stream source to update in the body of the request.
Success
required | object (stream_source_wowza) | ||||||||||||||
| |||||||||||||||
Unauthorized
Forbidden
Not Found
Gone
Unprocessable Entity
{- "stream_source_wowza": {
- "name": "My Updated Wowza Stream Source"
}
}{- "stream_source_wowza": {
- "created_at": "2020-01-29T17:16:22.001Z",
- "id": "brcndjJt",
- "name": "My Updated Wowza Stream Source",
- "primary_url": "rtmp://origin.cdn.wowza.com:1935/live",
- "state": "stopped",
- "stream_name": "0I3abc1FPZ2P3Qxdfz3YwKtZdDqu6102",
- "updated_at": "2020-01-31T14:56:21.001Z"
}
}(Available from version 1.4) This operation deletes a Wowza stream source.
No Content
Unauthorized
Forbidden
Not Found
Gone
Unprocessable Entity
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "DELETE" \ "${WV_HOST}/api/v1.11/stream_sources/wowza/2adffc17"
{- "Example Response 1": {
- "meta": {
- "status": 401,
- "code": "ERR-401-NoApiKey",
- "title": "No API Key Error",
- "message": "No API key sent in header.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 2": {
- "meta": {
- "status": 401,
- "code": "ERR-401-NoAccessKey",
- "title": "No Access Key Error",
- "message": "No access key sent in header.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 3": {
- "meta": {
- "status": 401,
- "code": "ERR-401-InvalidApiKey",
- "title": "Invalid Api Key Error",
- "message": "Invalid API key.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 4": {
- "meta": {
- "status": 401,
- "code": "ERR-401-InvalidAccessKey",
- "title": "Invalid Access Key Error",
- "message": "Invalid access key.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 5": {
- "meta": {
- "status": 401,
- "code": "ERR-401-BadAccountStatus",
- "title": "Bad Account Status Error",
- "message": "Your account's status doesn't allow this action.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 6": {
- "meta": {
- "status": 401,
- "code": "ERR-401-FeatureNotEnabled",
- "title": "Feature Not Enabled Error",
- "message": "This feature isn't enabled.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 7": {
- "meta": {
- "status": 401,
- "code": "ERR-401-TrialExceeded",
- "title": "Bad Billing Status Error",
- "message": "Your billing status needs attention. You can't start or add live streams until your billing status is updated.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 8": {
- "meta": {
- "status": 401,
- "code": "ERR-401-ExpiredToken",
- "title": "JWT is expired",
- "message": "Token has exired.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 9": {
- "meta": {
- "status": 401,
- "code": "ERR-401-InvalidToken",
- "title": "JWT is invalid",
- "message": "Token is invalid.",
- "description": "",
- "links": [ ]
}
}
}