Skip to main content

Playback Authentication

Access token generated using Testpress API which is required to authorize video playback. Embed code you generated from the admin portal will contain an access token that won't have an expiry date.

If the user has that code he can embed your video onto any page on the internet if you don't have domain restrictions. even if you have, users can view the video by embedding your video on your home or any other page that doesn't restrict users.

You can prevent the above scenario by generating an access token using API with time-to-live or set to expire after one usage on the back-end server and then sent to the website front-end and use generate access_token as part of the video embed code.

Obtaining an Access token

To generate the Access token you need to send an HTTP POST request to the API Endpoint, with the authentication Header and the optional Access token request Body.{video-id}/access-tokens

You can get the video ID from the admin portal under the video title.

Optional Fields

time_to_liveintegerBy default, the Access token validity is set to infinity. You can create shorter-lived URLs by passing the time_to_live parameter. This value is to be set in seconds
expires_after_first_usagebooleanPassing true will make the access token expire immediately after the first usage
annotationsjsonJSON contain all the information about the watermark. Please refer to this doc for details on watermarking.
curl --request POST \
--url \
--header 'authorization: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6MiwidXNlcl9pZCI6MiwiaW5zdGl0dXRlIjoxNjU1LCJpZCI6MiwiZXhwIjoxNjcxMDkxODE4LCJlbWFpbCI6InN1cHBvcnRAdGVzdHByZXNzLmluIn0.unnuHYMnu_6rxaiOMFouN5-O57psCVb5j7DWq9B28k8' \
--header 'cache-control: no-cache' \
--header 'content-type: application/json' \
--data '{"time_to_live": 600, "expires_after_first_usage": "true"}'

For valid requests the API server returns a JSON:

"url": "{video-id}/access-tokens/ea806eb5-4576-4bef-8489-204e78115d5a/",
"expires_after_first_usage": true,
"code": "ea806eb5-4576-4bef-8489-204e78115d5a",
"status": "Active",
"valid_until": "2022-08-29T12:43:11.288874Z",
"playback_url": "{video-id}/?access-tokens=ea806eb5-4576-4bef-8489-204e78115d5a"