Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wowza players API

The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.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.

Wowza players API is one of 48 APIs that Wowza publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include players. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, and a changelog.

This API exposes 10 operations across 6 paths, and defines 16 schemas. It is described by OpenAPI 3.0.3, at version 2.0.0.

Requests are made against a single base URL, http://localhost:8087.

10 operations 6 paths 16 schemas 1 DELETE5 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0.0
Base URL
https://api.video.wowza.com/api/v2.0
Authentication
HTTP Basic, HTTP Digest
Resource Areas
1

Authentication & Security 2

Wowza players API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). It uses HTTP digest authentication (digestAuth). By default, every request must be authenticated.

  • basicAuth — HTTP Basic Authentication using Wowza Streaming Engine admin credentials
  • digestAuth — HTTP Digest Authentication

Paths & Operations 10

Across 6 paths, the API surfaces 10 operations — 1 DELETE, 5 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

players 10

The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored. Operat…

GET
/players
Fetch all players
listPlayers 2 params → 200401
GET
/players/{id}
Fetch a player
showPlayer 1 param → 200401403404410
PATCH
/players/{id}
Update a player
updatePlayer 1 param body → 200401403404410422
POST
/players/{id}/rebuild
Rebuild player code
requestPlayerRebuild 1 param → 200401403404410
GET
/players/{id}/state
Fetch the state of a player
showPlayerState 1 param → 200401403404410
POST
/players/{player_id}/urls
Create a player URL
createPlayerUrl 1 param body → 200401422
GET
/players/{player_id}/urls
Fetch all player URLs
listPlayerUrls 1 param → 200401403404410
GET
/players/{player_id}/urls/{id}
Fetch a player URL
showPlayerUrl 2 params → 200401403404410
PATCH
/players/{player_id}/urls/{id}
Update a player URL
updatePlayerUrl 2 params body → 200401403404410422
DELETE
/players/{player_id}/urls/{id}
Delete a player URL
deletePlayerUrl 2 params → 204401403404410422

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are player (17 properties), url (9 properties), hosted_page_response_object (6 properties), hosted_page_request_object (6 properties). Each schema is shown below with its type and property counts.

Error403
object
1 property 1 required
player
object
17 properties
url_create_input
Error401
object
1 property 1 required
players
object
1 property 1 required
url
object
9 properties
Error422
object
1 property 1 required
Error410
object
1 property 1 required
hosted_page_response_object
object
Configuration of the hosted page.
6 properties
urls
object
1 property 1 required
player_update_input
object
1 property 1 required
url_input
object
1 property 1 required
index_player
object
5 properties
url_update_input
Error404
object
1 property 1 required
hosted_page_request_object
object
Configuration of the hosted page.
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wowza-players-api-openapi.yml Raw ↑

Other APIs Wowza publishes across the network.

Wowza Streaming Engine Java API
Wowza Flowplayer
Wowza GoCoder SDK
Wowza Real-Time Streaming SDK
Wowza advanced_token_authentication API
Wowza analytics_engagement API
Wowza analytics_ingest API
Wowza analytics_popularity API
Wowza analytics_viewers API
Wowza Applications API
Wowza assets API
Wowza categories API