Aller au contenu
ondaclipdocs

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é.

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 :

Fenêtre de terminal
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.

Votre serveur envoie la clé à l’adresse indiquée sur la page Intégration :

GET https://studio.ondaclip.com/api/delivery/<produit>/manifest
Authorization: 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.

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>
))
}

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.

Votre application reçoit les nouvelles vidéos la prochaine fois que votre serveur demande la liste. Rien à changer dans votre code.