Operations related to players, which are created through the /live_streams
resource. Players created through Wowza Video live streams can be embedded into your own web page or played through a web page hosted by Wowza Video.
This operation shows limited details for all of your players. For detailed information, fetch a single player.
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 (players) | ||||||||||
Array
|
Unauthorized
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.10/players"
{- "players": [
- {
- "created_at": "2020-01-29T17:16:21.968Z",
- "id": "e8dk5bf6",
- "transcoder_id": "6Qbymbbq",
- "type": "wowza_flowplayer",
- "updated_at": "2020-01-31T07:42:03.968Z"
}, - {
- "created_at": "2020-01-29T17:16:21.968Z",
- "id": "s3jmdnbl",
- "transcoder_id": "3kbb0hvf",
- "type": "wowza_flowplayer",
- "updated_at": "2020-01-31T02:22:29.968Z"
}
]
}
This operation shows details of a specific player.
Success
required | object (player) | ||||||||||||||||||||||||||||||
|
Unauthorized
Forbidden
Not Found
Gone
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.10/players/2adffc17"
{- "player": {
- "countdown": true,
- "countdown_at": "2020-02-01T17:00:00.000Z",
- "created_at": "2020-01-29T17:16:21.968Z",
- "embed_code": null,
- "hosted_page": {
- "enabled": true,
- "description": "My Hosted Page Description",
- "logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/hosted_page_logo_image/23424/5bad28.jpg",
- "sharing_icons": false,
- "title": "My Hosted Page",
}, - "id": "e8dk5bf6",
- "logo_position": "top-right",
- "responsive": false,
- "transcoder_id": "6Qbymbbq",
- "type": "wowza_flowplayer",
- "updated_at": "2020-01-31T16:08:26.990Z",
- "video_poster_image_url": "https://prod.s3.amazonaws.com/uploads/player/video_poster_image/23424/5bad28.jpg",
- "width": 640
}
}
This operation updates a player.
Provide the details of the player to update in the body of the request.
required | object (player) | ||||||||||||||||||||||
|
Success
required | object (player) | ||||||||||||||||||||||||||||||
|
Unauthorized
Forbidden
Not Found
Gone
Unprocessable Entity
{- "player": {
- "hosted_page": {
- "title": "My Updated Hosted Page"
}, - "responsive": true
}
}
{- "player": {
- "countdown": true,
- "countdown_at": "2020-02-01T17:00:00.000Z",
- "created_at": "2020-01-29T17:16:21.968Z",
- "embed_code": null,
- "hosted_page": {
- "enabled": true,
- "description": "My Hosted Page Description",
- "logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/hosted_page_logo_image/23424/5bad28.jpg",
- "sharing_icons": false,
- "title": "My Hosted Page",
}, - "id": "e8dk5bf6",
- "logo_position": "top-right",
- "responsive": false,
- "transcoder_id": "6Qbymbbq",
- "type": "wowza_flowplayer",
- "updated_at": "2020-01-31T16:08:26.990Z",
- "video_poster_image_url": "https://prod.s3.amazonaws.com/uploads/player/video_poster_image/23424/5bad28.jpg",
- "width": 640
}
}
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "POST" \ "${WV_HOST}/api/v1.10/players/2adffc17/rebuild"
{- "player": {
- "state": "requested"
}
}
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.10/players/2adffc17/state"
{- "player": {
- "state": "activated"
}
}
This operation creates a new player URL.
Provide the details of the player URL to create in the body of the request.
Success
required | object (url) | ||||||||||||||||||
|
Unauthorized
Unprocessable Entity
{- "url": {
- "bitrate": 4128,
- "height": 1080,
- "label": "1920",
- "width": 1920
}
}
{- "url": {
- "bitrate": 4138,
- "height": 1080,
- "id": "w9vJm3BJ",
- "label": "1920",
- "player_id": "Jm1tPblTJm1t",
- "width": 1920
}
}
This operation shows the details of all player URLs.
Success
required | Array of objects (url) | ||||||||||||||||||
Array
|
Unauthorized
Forbidden
Not Found
Gone
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.10/players/2adffc17/urls"
{- "urls": [
- {
- "bitrate": 4138,
- "height": 1080,
- "id": "w9vJm3BJ",
- "label": "1920",
- "player_id": "Jm1tPblTJm1t",
- "width": 1920
}, - {
- "bitrate": 4138,
- "height": 1080,
- "id": "PPqV0kcm",
- "label": "iPhone",
- "player_id": "Jm1tPblTJm1t",
- "transcoder_id": "yjCVYf5l",
- "width": 1920
}
]
}
This operation shows the details of a player URL.
Success
required | object (url) | ||||||||||||||||||
|
Unauthorized
Forbidden
Not Found
Gone
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v1.10/players/2adffc17/urls/1acfg43d"
{- "url": {
- "bitrate": 4138,
- "height": 1080,
- "id": "w9vJm3BJ",
- "label": "1920",
- "player_id": "Jm1tPblTJm1t",
- "width": 1920
}
}
This operation updates a player URL.
Provide the details of the player URL to update in the body of the request.
required | object (url) | ||||||||||
|
Success
required | object (url) | ||||||||||||||||||
|
Unauthorized
Forbidden
Not Found
Gone
Unprocessable Entity
{- "url": {
- "bitrate": 4128,
- "height": 1080,
- "label": "1920",
- "width": 1920
}
}
{- "url": {
- "bitrate": 4138,
- "height": 1080,
- "id": "w9vJm3BJ",
- "label": "1920",
- "player_id": "Jm1tPblTJm1t",
- "width": 1920
}
}
This operation deletes a player URL.
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.10/players/2adffc17/urls/1acfg43d"
{- "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": [ ]
}
}
}