# Afficher les vidéos dans votre application

> Intégrez vos vidéos Ondaclip approuvées dans votre application : une clé de livraison sur votre serveur, une liste privée, un lecteur par étape.

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

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 :

```bash
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

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

```http
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 :

```js
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 :

```python

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

Votre serveur transmet la liste à la page. Un lecteur par étape suffit :

```jsx
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

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](/docs/fr/for-ai-agents/) 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

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

Source: https://ondaclip.com/docs/fr/show-videos/
