In this guide, we'll explain how you can manage access to your videos on the Wavestream platform using the accessType attribute in your video model, which allows you to define your video as public or private.
Understanding the accessType Attribute
Each video on Wavestream has an attribute called accessType. This attribute controls the accessibility of your video and can take two possible values: public or private.
description: define the accessType of the video, if private the video URI can only be accessed with a signed url
By default, the accessType is set to public. If you set it to private, the video URI can only be accessed with a signed URL.
Updating Video accessType
To update the accessType of a video, a
PUT request should be made to the
/videos/:videoId endpoint. Here's an example using curl:
curl -X PUT "https://api.wavestream.com/videos/:videoId" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
Remember to replace
:videoId with the actual ID of the video and
YOUR_API_KEY with your actual API key.
Accessing Private Videos
To access a private video, the content owner must be signed in to the Wavestream platform. After that, a
GET request can be made to
The response will contain the destinationUri field which carries the signed URL for the private video.
curl -X GET "https://api.wavestream.com/videos/:videoId" \
-H "x-api-key: YOUR_API_KEY"
Which will give a response similar to this:
The signed URL, which is present in the destinationUri field of the response, will be valid for 3 hours by default.
Custom Integrations and TTL
If you require custom integrations or need to adjust the TTL for your signed URLs, please reach out to us through our support channel. We are dedicated to ensuring your needs are met.
With this guide, you can confidently manage and control the access to your video content on the Wavestream platform.