underlost / Wonderstream-API

Documentation and Samples for the Official Wonderstream API

Wonderstream API

Overview

Wonderstream provides a robust API that allows authenticated users to retrieve and purchase livestreams. To access the API, you must have a registered Wonderstream account. If you wish to create livestreams, you will also need to have a valid credit card associated with your account.

Authentication Methods

Wonderstream uses a simple token-based HTTP Authentication scheme. All endpoints require this token to be passed in the header.

Obtaining an Authentication Token

To retrieve your unique token, you will first have to login to your Wonderstream account, then navigate to the API section in your account page (https://wonderstream.net/account/). You’ll find your first key there. If you wish to generate a new key for any reason, you can make a POST request to https://wonderstream.net/api/v1/token/ with your username and Password. A new token will be generated every time you make a valid POST.

API Endpoints

https://wonderstream.net/api/v1/current/

• {{GET}} Displays the currently logged in user’s data.

---

https://wonderstream.net/api/v1/current/payments/

• {{ GET }} Displays currently logged in user’s payment history.

---

https://wonderstream.net/api/v1/current/livestreams/

• {{ GET }} Displays currently logged in user’s livestreams.

---

https://wonderstream.net/api/v1/purchase/

• {{ POST }} Purchases a new livestream, and bills the credit card on file that belongs to the user account associated with the authentication token.
• When creating a new livestream, you will have to also submit the email address that the token belongs to.
• (Requires the token to match the user that is being passed. For example, if JaneDoe has the token 1234, a successful POST can only be made if the username specified is JaneDoe, with the token 1234 passed a long in the header.)

---

https://wonderstream.net/api/v1/livestreams/

• {{ GET }} Returns a list of all publically viewable livestreams.

---

https://wonderstream.net/api/v1/livestreams/<id>/ {{ GET, PUT }}

• GET Retrieves the details of a specific livestream.
• PUT Update data of a specific livestream (Requires the token to match that of the livestream ID’s Owner)

---

https://wonderstream.net/api/v1/livestreams/<id>/sponsors/ {{ GET, POST, PUT }}

• GET Retrieves a list of sponsors associated with a livestream.
• PUT Update content of the existing sponsors (Requires the token to match that of the livestream ID’s Owner)
• POST Create a new sponsor associated with the livestream event. (Requires the token to match that of the livestream ID’s Owner)

---

https://wonderstream.net/api/v1/livestreams/<id>/start/

• {{PUT}} Forces a livestream to start, even if it’s technically not scheduled to. (Requires the token to match that of the livestream ID’s Owner)

---

https://wonderstream.net/api/v1/livestreams/<id>/stop/

• {{ PUT }} Forces a livestream to stop, even if it’s technically not scheduled to. (Requires the token to match that of the livestream ID’s Owner)

---

https://wonderstream.net/api/v1/featured/

• {{ GET }} Displays a list of the most recent featured livestreams found on https://wonderstream.net/watch-now/

---

https://wonderstream.net/api/v1/featured/promoted/

• {{ GET }} Displays a list of the most recent promoted livestreams found on https://wonderstream.net/watch-now/

---

https://wonderstream.net/api/v1/users/<username>/livestreams/

• {{ GET }} Retrieves a list of livestreams of a specific user.

---