API referencePlayback
Resolve a playback session from its token
Resolve a playback session from its token
GET
/v1/playback/sessions/{sid}Called by the embedded player to exchange the sessionToken for the
signed manifest URL and a fresh watermark token. Auth: the
videohati-session-token header. Rate limit: 30 requests per 60 s per
session.
Error codes: session_invalid (403), session_expired (403),
session_revoked_concurrent_cap (403).
Authentication
- playbackSessionToken — Playback session ownership token (
<sessionId>.<expiryUnix>.<mac>) returned byPOST /v1/playback/sessions.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
sid | path | string (Ulid) | Yes | Playback session id. |
Request body
This operation takes no request body.
Responses
| Status | Meaning |
|---|---|
200 | Session detail for the player. |
403 | The credential is valid but does not permit this action. The per-operation description lists the exact error.code values. |
429 | Rate limit exceeded. |