Show the videos in your app
Once your clips are approved and published, your app can show them. Your videos stay private. Your server fetches the list of published videos from Ondaclip, and every video address in that list is signed and works for a few hours only.
This page covers products in Ondaclip Cloud. If your product runs on your own infrastructure, your videos are published to your own storage: the Integrate page in the studio gives you the code for that setup.
1. Create a delivery key
Section titled “1. Create a delivery key”In the studio, open your product, then Integrate. Under Delivery keys, name the key after the environment that will use it (production, staging) and select Create key.
Copy the key right away: you won’t see it again. Save it on your server as an environment variable:
ONDACLIP_DELIVERY_KEY=ondk_...Keep the key on the server. Never put it in a page, a mobile app or your repository. If a key leaks, revoke it in the same place: apps using it stop getting your videos right away.
Only workspace admins can create and revoke keys.
2. Fetch the list from your server
Section titled “2. Fetch the list from your server”Your server sends the key to the address shown on the Integrate page:
GET https://studio.ondaclip.com/api/delivery/<product>/manifestAuthorization: Bearer <your delivery key>You get the published list: chapters, tutorials and their steps, in every language. Each video, poster and image is a full address that plays for 6 hours. Cache the list on your server for up to an hour, then fetch it again.
In Node:
const KEY = process.env.ONDACLIP_DELIVERY_KEY
export async function tutorials(locale = "en-US") { const r = await fetch("https://studio.ondaclip.com/api/delivery/<product>/manifest", { headers: { Authorization: `Bearer ${KEY}` }, }) if (!r.ok) throw new Error(`Ondaclip: ${r.status}`) const manifest = await r.json() return manifest.chapters.map((chapter) => ({ title: chapter.title[locale], tutorials: chapter.tutorials.map((t) => ({ id: t.id, title: t.title[locale], thumbnail: t.thumbnail[locale], steps: t.steps.map((s) => ({ title: s.title[locale], video: s.video[locale], poster: s.image[locale], transcript: s.transcript[locale], })), })), }))}In Python:
import os, requests
KEY = os.environ["ONDACLIP_DELIVERY_KEY"]
def tutorials(locale="en-US"): url = "https://studio.ondaclip.com/api/delivery/<product>/manifest" manifest = requests.get(url, headers={"Authorization": f"Bearer {KEY}"}, timeout=10).json() return [{ "title": chapter["title"][locale], "tutorials": [{ "id": t["id"], "title": t["title"][locale], "steps": [{"title": s["title"][locale], "video": s["video"][locale], "poster": s["image"][locale]} for s in t["steps"]], } for t in chapter["tutorials"]], } for chapter in manifest["chapters"]]The Integrate page gives you the same code with your product’s address already filled in.
3. Play each step in a page
Section titled “3. Play each step in a page”Your server passes the list to the page. One player per step is all you need:
export function Tutorials({ chapters }) { return chapters.map((chapter) => ( <section key={chapter.title}> <h2>{chapter.title}</h2> {chapter.tutorials.map((t) => ( <article key={t.id}> <h3>{t.title}</h3> {t.steps.map((step) => ( <figure key={step.video}> <video src={step.video} poster={step.poster} controls preload="none" /> <figcaption>{step.title}</figcaption> </figure> ))} </article> ))} </section> ))}Let your AI agent do it
Section titled “Let your AI agent do it”Your AI agent can wire all of this for you. Ask it to “show our Ondaclip videos in the app”: the integration tool of the Ondaclip MCP server gives it the address and the code. It will ask you for the delivery key, since only a person can create one in the studio.
When you publish again
Section titled “When you publish again”Your app picks up new videos the next time your server fetches the list. Nothing to change in your code.