History: Request playback

Every change to this page, newest first. Expand an entry to see what changed.

← Request playback

1. 1 Oct 2026 · +2 −1 lines
   Show changes

   ⋯
     ```
     
   - **Scope:** `playback` (issued by Wandura only)
   + **Scope:** `playback` (create it yourself on **Developers** → **Stream films in an app**; if it leaks, anyone can stream your licensed films, so revoke it immediately)
     
     ## Description
   ⋯
     | 503 | `not_ready` | No playable version of the episode is available right now. |
     | 503 | `service_unavailable` | Wandura could not verify the API key in time. The key is not wrong: retry after `Retry-After` seconds, with backoff. |
   + | 503 | `service_unavailable` | The video provider did not answer in time (`The video provider did not answer in time — retry`). The episode is not missing: retry after `Retry-After` seconds, with backoff. |
     
     Example `403`:
   ⋯

2. 1 Oct 2026 · +3 −2 lines
   Show changes

   ⋯
     | `union_info` | body | string | Yes, for encrypted episodes | Device ID generated by the Player SDK on the viewer's device. Send together with `drm_kek`. |
     | `drm_kek` | body | string | Yes, for encrypted episodes | Device public key generated by the Player SDK. Send together with `union_info`. |
   - | `intent` | body | string | No | `play` when the viewer tapped the episode, `prefetch` when your app loads it ahead of a tap. Prefetch requests are not counted as plays. Other values are recorded as unknown and never rejected. |
   + | `intent` | body | string | No | `play` when the viewer tapped the episode, `prefetch` when your app loads it ahead of a tap. Prefetch requests are not counted as plays. A missing or other value is recorded as unknown, never rejected, and counted as a play. |
     | `viewer_ref` | body | string | No | Your own opaque session or device identifier, stored with the ticket for support lookups. Do not include personal data. |
     
   - `union_info` and `drm_kek` are rejected with `400` `invalid_device_info` when they look empty (for example `"(null)"`, `"null"`, `"nil"`, `"undefined"`, `"none"`) or are shorter than 8 characters.
   + `union_info` and `drm_kek` are rejected with `400` `invalid_device_info` when, after trimming spaces, a value is shorter than 8 characters or is one of `(null)`, `null`, `nil`, `undefined`, `nan`, `<null>` or `none` (in any letter case).
     
     ## Request example
   ⋯
     | 502 | none | The stream could not be prepared or the play token could not be signed. Retry with backoff. |
     | 503 | `not_ready` | No playable version of the episode is available right now. |
   + | 503 | `service_unavailable` | Wandura could not verify the API key in time. The key is not wrong: retry after `Retry-After` seconds, with backoff. |
     
     Example `403`:
   ⋯

3. 29 Sept 2026 · Page created