---
title: "Integratiegids voor Strapi"
url: "https://helpdesk.kontainer.com/nl/article/integratiegids-voor-strapi/"
type: "article"
category: ["Beheerinstellingen", "Integraties & plug-ins"]
tags: ["Add-onfunctie", "Premium+-abonnementen", "DAM"]
language: "nl"
published: "2026-10-07T10:46:41+00:00"
updated: "2026-10-07T12:11:01+00:00"
summary: "Met de Strapi-integratie van Kontainer voeg je eenvoudig afbeeldingen, video's en bestanden rechtstreeks uit je DAM in het beheerpaneel van Strapi in – zonder handmatig downloaden en uploaden."
---

# Integratiegids voor Strapi

Met de Strapi-integratie van Kontainer kiezen je redacteuren afbeeldingen, video's en bestanden rechtstreeks uit je DAM, zonder bestanden naar Strapi te uploaden. Strapi slaat alleen een verwijzing naar het bestand op; het eigenlijke bestand blijft in Kontainer en wordt via een CDN geleverd.

Op de [integratiepagina](https://kontainer.com/nl/integrations) van Kontainer leest je meer over toepassingen, voordelen en meer.

## Vereisten

- Strapi v5 (Strapi v4 wordt niet ondersteund)
- Node.js 18+
- Een Kontainer-account (https://jouwbedrijf.kontainer.com)
- Een ontwikkelaar met toegang tot je Strapi-codebase en de mogelijkheid om uit te rollen

## Wat wordt waar opgeslagen?

Je bestanden blijven in Kontainer. Er wordt niets geüpload naar de mediabibliotheek van Strapi. Strapi slaat alleen een JSON-verwijzing naar het bestand op, met daarin:

- `fileId, fileName, folderId` – identificatiegegevens om het bestand op te halen
- `url` – de CDN-URL, inclusief het downloadsjabloon dat je hebt gekozen
- `thumbnailUrl, type, extension, dimensions, size`
- `alt, description` en elk aangepast veld uit Kontainer

Omdat de alt-tekst en alle waarden van aangepaste velden met de verwijzing meereizen, hoeven redacteuren metadata niet opnieuw in te typen in Strapi, en kan je frontend ze rechtstreeks uit het antwoord van de Strapi-API lezen.

## Aan de slag

### 1. De plug-in installeren

Voer in je Strapi-project uit:

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

Commit package.json en package-lock.json, zodat de plug-in met je uitrol meekomt. Strapi vindt de plug-in automatisch en schakelt hem in – er zijn geen wijzigingen in configuratiebestanden nodig.

### 2. Het Kontainer-veld aan een contenttype toevoegen

Kies in de Content-Type Builder Custom fields → Kontainer media, of voeg het rechtstreeks aan het schema toe:

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

De Content-Type Builder is in productie alleen-lezen, dus voer deze wijziging uit in je ontwikkelomgeving en rol de schemawijziging uit.

### 3. Bouwen

De beheerinterface van de plug-in wordt in de admin-bundel gecompileerd. Deze stap is vereist – zonder de knop "Choose from Kontainer" verschijnt niet.

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

### 4. Verbinding maken met Kontainer

Ga naar Settings → Kontainer → Configuration en voer je Kontainer-URL in. Dat is de hele inrichting – er zijn geen API-sleutels of omgevingsvariabelen nodig.

De instellingen worden in de Strapi-database opgeslagen, dus je moet ze één keer per omgeving instellen (staging en productie afzonderlijk).

### 5. Bestanden kiezen

Klik in de editor bij het veld op Choose from Kontainer. Blader, zoek en filter in je Kontainer-bibliotheek, pas eventueel een downloadsjabloon toe (bijsnijden, formaat wijzigen, bestandsformaat) en kies het bestand. Strapi slaat de verwijzing op; de CDN-URL weerspiegelt het sjabloon dat je hebt gekozen.

## Optioneel: gebruik van bestanden bijhouden

Kontainer kan laten zien waar elk bestand in Strapi wordt gebruikt. Klik onder Settings → Kontainer op Generate om een token aan te maken, en registreer daarna de getoonde endpoint-URL plus het token als integratie in Kontainer onder Settings → Integrations. Kontainer bevraagt Strapi daarna en rapporteert het gebruik over alle contenttypen, inclusief concepten, locales, componenten en dynamische zones.

## De verwijzing in je frontend gebruiken

De verwijzing komt ongewijzigd terug uit de content-API van Strapi:

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

Vraag het bestand op via `url` – het wordt geleverd vanuit het CDN van Kontainer.

## Support

Heb je hulp nodig bij het instellen of configureren van de Strapi-plug-in? Ons supportteam helpt je graag.

Neem contact op via: [support@kontainer.com](mailto:support@kontainer.com)

## Other languages

- [English](https://helpdesk.kontainer.com/article/strapi-integration-guide/index.md)
- [Deutsch](https://helpdesk.kontainer.com/de/article/strapi-integrationsleitfaden/index.md)
- [Svenska](https://helpdesk.kontainer.com/sv/article/integrationsguide-for-strapi/index.md)
- [Dansk](https://helpdesk.kontainer.com/da/article/integrationsguide-til-strapi/index.md)

## Related articles

- [Kontainer x Drupal – plug-ingids](https://helpdesk.kontainer.com/nl/article/kontainer-x-drupal-plug-ingids/index.md): Premium+-functie Installeer onze plug-in om een Kontainer-knop aan je Drupal-cms toe te voegen. Verbeter je Drupal-ervaring met naadloze media-imports, efficiënte CDN-integratie en aanpasbare opmaaksj…
- [Integratiegids voor TYPO3](https://helpdesk.kontainer.com/nl/article/integratiegids-voor-typo3/index.md): Met de Kontainer-integratie voor TYPO3 verbindt je je centrale Digital Asset Management-systeem (DAM) rechtstreeks met je TYPO3-cms. Redacteuren en ontwikkelaars zoeken, kiezen en voegen afbeeldingen,…
- [Integratiegids voor WordPress](https://helpdesk.kontainer.com/nl/article/integratiegids-voor-wordpress/index.md): Met de WordPress-integratie van Kontainer voeg je eenvoudig afbeeldingen, video's en bestanden rechtstreeks uit je DAM in WordPress in – zonder handmatig downloaden en uploaden.
- [Gids voor de HubSpot-plug-in](https://helpdesk.kontainer.com/nl/article/gids-voor-de-hubspot-plug-in/index.md): Werk sneller en maak aantrekkelijkere HubSpot-websites en -landingspagina's met directe toegang tot je centraal beheerde afbeeldingenbibliotheek in Kontainer. Met onze HubSpot-plug-in zoekt, kiest en…