# Wandura Delivery API

The Wandura Delivery API lets your backend stream the short-drama films your organisation has licensed from Wandura. Your server reads your licensed catalog, asks Wandura for a short-lived playback ticket each time a viewer starts an episode, and hands that ticket to the Player SDK on the viewer's device. The same API delivers a feed of your approved ad creatives, and a lighter open video path for content with nothing to protect.

## What the API gives you
| Capability | Endpoint | What you get |
|---|---|---|
| Licensed catalog | `GET /api/delivery/v1/catalog` | Every film and episode you may stream now: display order, free-episode rule, readiness per episode. Metadata only. |
| Playback tickets | `POST /api/delivery/v1/playback` | Up to 3 tickets per call (an episode and the next two), each valid 30 minutes, with the episode's subtitles. |
| Creatives feed | `GET /api/delivery/v1/creatives`, `GET /api/delivery/v1/creatives/{id}` | A record per approved ad creative of your organisation. |
| Open video | `GET /api/delivery/v1/videos`, `GET /api/delivery/v1/videos/{id}` | Signed MP4 links for content with no rights to protect. |
| Configuration | `GET /api/delivery/v1/config` | Your limits, versions, playback settings and deprecations, for your key. |

Base URL: `https://www.wandura.ai` (with `www`). Server-to-server only. Everything you can rely on, in one place: [Canonical API behaviour](https://docs.wandura.ai/v1/developers/reference/behaviour).

## Where to start
## The API at a glance
| Topic | Read |
|---|---|
| Keys and scopes | [Authentication](https://docs.wandura.ai/v1/developers/authentication) |
| Keeping it safe | [Security](https://docs.wandura.ai/v1/developers/concepts/security) |
| What can go wrong | [Errors](https://docs.wandura.ai/v1/developers/concepts/errors), [Rate limits](https://docs.wandura.ai/v1/developers/concepts/rate-limits) |
| The app side | [Player SDK](https://docs.wandura.ai/v1/developers/player-sdk) |
| Testing | [Testing](https://docs.wandura.ai/v1/developers/guides/testing) |
| Going live | [Go-live checklist](https://docs.wandura.ai/v1/developers/production/go-live) |
| Every endpoint | [API reference](https://docs.wandura.ai/v1/developers/reference/overview) |
| What changed | [Changelog](https://docs.wandura.ai/changelog) |