Afficher les vidéos dans votre application
Une fois vos clips approuvés et publiés, votre application peut les afficher. Vos vidéos restent privées : votre serveur récupère auprès d’Ondaclip la liste des vidéos publiées, et chaque adresse de cette liste est signée et ne fonctionne que quelques heures.
Cette page concerne les produits dans Ondaclip Cloud. Si votre produit tourne sur votre propre infrastructure, vos vidéos sont publiées dans votre propre stockage : la page Intégration du studio vous donne le code adapté.
1. Créer une clé de livraison
Section intitulée « 1. Créer une clé de livraison »Dans le studio, ouvrez votre produit, puis Intégration. Sous Clés de livraison, donnez à la clé le nom de l’environnement qui l’utilisera (production, staging), puis cliquez sur Créer la clé.
Copiez la clé tout de suite : vous ne la reverrez plus. Enregistrez-la sur votre serveur dans une variable d’environnement :
ONDACLIP_DELIVERY_KEY=ondk_...La clé reste sur le serveur. Ne la mettez jamais dans une page, une application mobile ou votre dépôt. Si une clé fuite, révoquez-la au même endroit : les applications qui l’utilisent ne reçoivent plus vos vidéos, immédiatement.
Seuls les administrateurs de l’espace de travail peuvent créer et révoquer des clés.
2. Récupérer la liste depuis votre serveur
Section intitulée « 2. Récupérer la liste depuis votre serveur »Votre serveur envoie la clé à l’adresse indiquée sur la page Intégration :
GET https://studio.ondaclip.com/api/delivery/<produit>/manifestAuthorization: Bearer <votre clé de livraison>Vous recevez la liste publiée : chapitres, tutoriels et leurs étapes, dans toutes les langues. Chaque vidéo, affiche et image est une adresse complète, valable 6 heures. Gardez la liste en cache sur votre serveur une heure au plus, puis demandez-la de nouveau.
En Node :
const KEY = process.env.ONDACLIP_DELIVERY_KEY
export async function tutorials(locale = "fr-CA") { const r = await fetch("https://studio.ondaclip.com/api/delivery/<produit>/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], })), })), }))}En Python :
import os, requests
KEY = os.environ["ONDACLIP_DELIVERY_KEY"]
def tutorials(locale="fr-CA"): url = "https://studio.ondaclip.com/api/delivery/<produit>/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"]]La page Intégration vous donne le même code, avec l’adresse de votre produit déjà remplie.
3. Lire chaque étape dans une page
Section intitulée « 3. Lire chaque étape dans une page »Votre serveur transmet la liste à la page. Un lecteur par étape suffit :
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> ))}Laissez votre agent IA s’en charger
Section intitulée « Laissez votre agent IA s’en charger »Votre agent IA peut tout brancher pour vous. Demandez-lui d’« afficher nos vidéos Ondaclip dans l’application » : l’outil integration du serveur MCP Ondaclip lui donne l’adresse et le code. Il vous demandera la clé de livraison, car seule une personne peut la créer dans le studio.
Quand vous publiez de nouveau
Section intitulée « Quand vous publiez de nouveau »Votre application reçoit les nouvelles vidéos la prochaine fois que votre serveur demande la liste. Rien à changer dans votre code.