History: Open video (coming soon)

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

1 Oct 2026 · +7 −3 lines

Show changes

⋯
  1. **Register each app, get its key.** On partner.wandura.ai → **Developers** → **Apps**, add each app (name, iOS bundle ID, Android package name). Wandura gives the app its own API key with the `videos:read` scope. Keep it on your server like every other key. See [Authentication](authentication.md).
  2. **List.** Your server calls `GET /api/delivery/v1/videos` and stores the result. Each video comes with its title, duration, poster and a link per quality (480p and 720p MP4).
- 3. **Play.** Your app plays the link exactly as received, with the platform's standard player (AVPlayer, ExoPlayer, or an HTML `<video>` element). Links are signed and stay valid for a long period (about 30 days); your server refreshes the list regularly, so it always has current links. Links are cached close to your viewers.
+ 3. **Play.** Your app plays the link exactly as received, with the platform's standard player (AVPlayer, ExoPlayer, or an HTML `<video>` element). Links are signed and stay valid for **1 hour** from the moment the list is returned (the `expires_at` of each link tells you when). Links are cached close to your viewers.
+ 4. **Refresh.** Your server calls the list again **at least every 45 minutes** and hands your apps the fresh links. Apps always get links from your server when they need them; **never cache links in the app** or store them for later — an expired link stops playing.
  
+ > **Note:** Refreshing every 45 minutes is a small list call from your server only. Video plays go straight from the CDN to your viewers and never pass through Wandura.
+ 
  ## What you do not need {#not-needed}
  
⋯
  ## What changes compared with films {#differences}
  
- - **Anyone with a link can play it** until it expires. Only put content here that you are happy to share.
+ - **Anyone with a link can play it** until it expires (at most 1 hour). Only put content here that you are happy to share.
  - **Usage is reported per app without any app code.** Each link Wandura hands out is tied to the app whose key requested it, so data usage can be reported per partner and per app. Wandura does not count individual plays; if you need view numbers, record them in your app.
- - **Access is per app.** Revoking one app's key stops new links for that app only; your other apps keep working.
+ - **Access is per organisation.** Your keys see only the video collections Wandura has granted to your organisation, and only once they are published.
+ - **Keys are per app.** Revoking one app's key stops new lists for that app only; your other apps keep working. Links already handed out stop working when they expire, within 1 hour.
  
  ## Status and next steps {#status}
⋯

1 Oct 2026 · +1 −1 lines

Show changes

⋯
  ## Status and next steps {#status}
  
- This path is being designed. Ask your Wandura contact if you plan to use it; this page will be updated with the final endpoint, fields and errors when it goes live.
+ This path is being designed. Ask Wandura if you plan to use it; this page will be updated with the final endpoint, fields and errors when it goes live.

1 Oct 2026 · +6 −5 lines

Show changes

⋯
  ```
  
- 1. **Key.** A Wandura API key with a new `videos:read` scope, kept on your server like every other key. See [Authentication](authentication.md).
+ 1. **Register each app, get its key.** On partner.wandura.ai → **Developers** → **Apps**, add each app (name, iOS bundle ID, Android package name). Wandura gives the app its own API key with the `videos:read` scope. Keep it on your server like every other key. See [Authentication](authentication.md).
  2. **List.** Your server calls `GET /api/delivery/v1/videos` and stores the result. Each video comes with its title, duration, poster and a link per quality (480p and 720p MP4).
- 3. **Play.** Your app plays the link with the platform's standard player (AVPlayer, ExoPlayer, or an HTML `<video>` element). Links do not expire and are cached close to your viewers.
+ 3. **Play.** Your app plays the link exactly as received, with the platform's standard player (AVPlayer, ExoPlayer, or an HTML `<video>` element). Links are signed and stay valid for a long period (about 30 days); your server refreshes the list regularly, so it always has current links. Links are cached close to your viewers.
  
  ## What you do not need {#not-needed}
  
+ - No code in your app to identify itself: the link already carries it.
  - No playback tickets and no per-episode requests.
  - No Player SDK licence, so no licence fee for this path.
⋯
  ## What changes compared with films {#differences}
  
- - **Anyone with a link can play it.** That is the point of this path, so only put content here that you are happy to share.
- - **Wandura does not count individual plays.** If you need view numbers, record them in your app.
- - **Access is per key.** Wandura can stop your access to the list by revoking your key; links already in your app keep working.
+ - **Anyone with a link can play it** until it expires. Only put content here that you are happy to share.
+ - **Usage is reported per app without any app code.** Each link Wandura hands out is tied to the app whose key requested it, so data usage can be reported per partner and per app. Wandura does not count individual plays; if you need view numbers, record them in your app.
+ - **Access is per app.** Revoking one app's key stops new links for that app only; your other apps keep working.
  
  ## Status and next steps {#status}
⋯

1 Oct 2026 · Page created