Signed token to play a video or a live stream

Requires an enterprise service API key. memberOnly content additionally requires the X-Customer-Session header of a buyer with a current membership in the key’s organization (otherwise 403 MEMBERSHIP_REQUIRED). Content from another organization responds 404. Short-lived tokens: 30 minutes for live streams, 1 hour for videos.

POST/content/playback-token

Authorization

AuthorizationAPI key · headerrequired

API key prefixed with Bearer . Alternative: the x-api-key header with the raw key. Available scopes: read and write (see /.well-known/oauth-protected-resource).

x-api-keyAPI key · headerrequired

Raw API key (without Bearer ), alternative to Authorization.

Header parameters

X-Workspace-Idstring

Active workspace to operate on. Optional: when omitted, the default workspace of the user who owns the key is used (pickActiveOrg).

Request body

requiredapplication/json

kindstringrequired

Allowed:videolive

idstringrequired

min length 1

Responses

200

dataContentPlaybackTokenrequired

Show properties

playbackIdstringrequired

tokensobjectrequired

Show properties

playbackstringrequired

drmstringrequired

thumbnailstring

storyboardstring

401

Missing or invalid credential.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

403

Insufficient role or resource not accessible.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

404

Resource does not exist or is out of scope.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

422

Request body/parameter validation failed.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

X-Workspace-IdheaderActive workspace to operate on. Optional: when omitted, the default workspace of the user who owns the key is used (pickActiveOrg).

Bodyapplication/json

kindstring*idstring*

Request

curl -X POST 'https://admin.appfreeticket.com/api/v1/content/playback-token' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "kind": "video",
  "id": "string"
}'

const response = await fetch("https://admin.appfreeticket.com/api/v1/content/playback-token", {
  method: "POST",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: "{\n  \"kind\": \"video\",\n  \"id\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://admin.appfreeticket.com/api/v1/content/playback-token",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    data="{\n  \"kind\": \"video\",\n  \"id\": \"string\"\n}",
)

Response

{
  "data": {
    "playbackId": "string",
    "tokens": {
      "playback": "string",
      "drm": "string",
      "thumbnail": "string",
      "storyboard": "string"
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}