---
title: "Guide d’intégration de Strapi"
url: "https://helpdesk.kontainer.com/fr/article/guide-dintegration-strapi/"
type: "article"
category: ["Paramètres d'administration", "Intégrations et plugins"]
tags: ["Fonctionnalité complémentaire", "Offres Premium+", "DAM"]
language: "fr"
published: "2026-10-08T05:41:51+00:00"
updated: "2026-10-08T05:41:51+00:00"
summary: "Avec l'intégration de Kontainer à Strapi, vous pouvez insérer facilement des images, des vidéos et des fichiers directement depuis votre DAM dans l'interface d'administration de Strapi, sans télécharg…"
---

# Guide d’intégration de Strapi

Avec l'intégration de Kontainer à Strapi, vos éditeurs peuvent sélectionner des images, des vidéos et des fichiers directement depuis votre DAM, sans téléverser de fichiers dans Strapi.\
 Strapi ne conserve qu'une référence au fichier ; le fichier lui-même reste dans Kontainer et est diffusé via le CDN.

Rendez-vous sur la [page des intégrations](https://kontainer.com/fr/integrations) de Kontainer pour en savoir plus sur les cas d'usage, les avantages, etc.

## Prérequis

- Strapi v5 (Strapi v4 n'est pas pris en charge)
- Node.js 18 ou supérieur
- Un compte Kontainer (https://votreentreprise.kontainer.com)
- Un développeur ayant accès au code de votre Strapi et capable de le déployer

## Ce qui est stocké, et où

Vos fichiers restent dans Kontainer. Rien n'est téléversé dans la médiathèque de Strapi. Strapi ne stocke qu'une référence JSON au fichier, qui comprend :

- `fileId, fileName, folderId` : des identifiants pour retrouver le fichier
- `url` : l'URL CDN, avec le modèle de téléchargement que vous avez choisi
- `thumbnailUrl, type, extension, dimensions, size`
- `alt, description`et tous les champs personnalisés de Kontainer

Comme le texte alternatif et toutes les valeurs des champs personnalisés accompagnent la référence, les éditeurs n'ont pas à ressaisir les métadonnées dans Strapi, et votre frontend peut les lire directement dans la réponse de l'API Strapi.

## Pour commencer

### 1. Installer le plugin

Dans votre projet Strapi :

```
npm install @kontainer/strapi-plugin
```

Validez package.json et package-lock.json pour que le plugin soit livré avec votre déploiement. Strapi détecte et active le plugin automatiquement : aucune modification de fichier de configuration n'est nécessaire.

### 2. Ajouter le champ Kontainer à un type de contenu

Dans le Content-Type Builder, choisissez Custom fields → Kontainer media, ou ajoutez-le directement au schéma :

`"hero": {
"type": "customField",
"customField": "plugin::kontainer.media"
}`

Le Content-Type Builder est en lecture seule en production : effectuez donc cette modification dans votre environnement de développement, puis déployez la modification du schéma.

### 3. Compiler

L'interface d'administration du plugin est compilée dans le bundle d'administration. Cette étape est obligatoire : sans elle, le bouton « Choose from Kontainer » n'apparaît pas.

`npm ci --omit=dev
npm run build
npm run start`

### 4. Se connecter à Kontainer

Rendez-vous dans Settings → Kontainer → Configuration et saisissez l'URL de votre Kontainer. C'est toute la configuration : aucune clé d'API ni variable d'environnement n'est nécessaire.

Les paramètres sont enregistrés dans la base de données de Strapi : vous devrez donc les définir une fois par environnement (préproduction et production séparément).

### 5. Sélectionner des fichiers\

Dans l'éditeur, cliquez sur « Choose from Kontainer » dans le champ. Parcourez, recherchez et filtrez votre bibliothèque Kontainer, appliquez si besoin un modèle de téléchargement (recadrage, redimensionnement, format), puis sélectionnez le fichier. Strapi enregistre la référence ; l'URL CDN reflète le modèle que vous avez choisi.

## Facultatif : suivi de l'utilisation des fichiers

Kontainer peut vous montrer où chaque fichier est utilisé dans Strapi. Sous Settings → Kontainer, cliquez sur Generate pour créer un jeton, puis enregistrez l'URL du point d'accès affichée, avec le jeton, comme intégration dans Kontainer, sous Paramètres → Intégrations. Kontainer interroge ensuite Strapi et signale l'utilisation dans tous les types de contenu, y compris les brouillons, les langues, les composants et les zones dynamiques.

## Utiliser la référence dans votre frontend

La référence est renvoyée telle quelle par l'API de contenu de Strapi :

`const page = await fetch(`${STRAPI_URL}/api/pages/${documentId}`).then((r) => r.json());
const { url, alt } = page.data.hero;`

Appelez le fichier à partir de `url` : il est servi depuis le CDN de Kontainer.

## Support

Si vous avez besoin d'aide pour installer ou configurer le plugin Strapi, notre équipe de support se fera un plaisir de vous aider.

Contactez : [support@kontainer.com](mailto:support@kontainer.com)

## Other languages

- [English](https://helpdesk.kontainer.com/article/strapi-integration-guide/index.md)
- [Dansk](https://helpdesk.kontainer.com/da/article/integrationsguide-til-strapi/index.md)
- [Deutsch](https://helpdesk.kontainer.com/de/article/strapi-integrationsleitfaden/index.md)
- [Español](https://helpdesk.kontainer.com/es/article/guia-de-integracion-con-strapi/index.md)
- [Nederlands](https://helpdesk.kontainer.com/nl/article/integratiegids-voor-strapi/index.md)
- [Svenska](https://helpdesk.kontainer.com/sv/article/integrationsguide-for-strapi/index.md)

## Related articles

- [Notifications Slack depuis Kontainer](https://helpdesk.kontainer.com/fr/article/notifications-slack-depuis-kontainer/index.md): Recevez les notifications de Kontainer directement dans Slack et restez informé sans surveiller plusieurs systèmes. L'intégration de Slack vous permet de choisir précisément les notifications que vous…
- [Monter WebDAV sur Mac et Windows](https://helpdesk.kontainer.com/fr/article/monter-webdav-sur-mac-et-windows/index.md): Établissez une connexion WebDAV pour accéder aux fichiers de votre Kontainer comme à ceux d’un disque local, c’est-à-dire via le Finder sur Mac ou l’Explorateur de fichiers sur Windo…
- [Kontainer et Office (version M365) – guide du plugin](https://helpdesk.kontainer.com/fr/article/kontainer-et-office-version-m365-guide-du-plugin/index.md): Manuel du complément Office 365 À noter : si le plugin Office est inclus dans votre offre, il peut encore nécessiter une activation. Contactez le Customer Success si vous avez besoin d’aide…
- [Guide de configuration du plugin Figma](https://helpdesk.kontainer.com/fr/article/guide-de-configuration-du-plugin-figma/index.md): Configurer et utiliser le plugin Kontainer File Picker dans Figma Kontainer propose un plugin de sélection de fichiers pour l’application de design Figma, qui permet de parcourir et d’insé…