--- title: "Guía de integración con Strapi" url: "https://helpdesk.kontainer.com/es/article/guia-de-integracion-con-strapi/" type: "article" category: ["Ajustes de administración", "Integraciones y plugins"] tags: ["Función adicional", "Planes Premium+", "DAM"] language: "es" published: "2026-10-08T08:17:23+00:00" updated: "2026-10-08T08:17:23+00:00" summary: "Con la integración de Kontainer con Strapi, puedes insertar imágenes, vídeos y archivos directamente desde tu DAM en el panel de administración de Strapi, sin descargarlos y subirlos a mano." --- # Guía de integración con Strapi Con la integración de Kontainer con Strapi, tus editores pueden elegir imágenes, vídeos y archivos directamente desde tu DAM sin subir archivos a Strapi.\ Strapi solo guarda una referencia al archivo; el archivo en sí permanece en Kontainer y se entrega a través de la CDN. Ve a la [página de integraciones](https://kontainer.com/es/integraciones) de Kontainer para saber más sobre los casos de uso, las ventajas y más. ## Requisitos - Strapi v5 (Strapi v4 no es compatible) - Node.js 18 o superior - Una cuenta de Kontainer (https://yourcompany.kontainer.com) - Un desarrollador con acceso al código de tu Strapi y con capacidad para desplegar ## ¿Qué se guarda y dónde? Tus archivos se quedan en Kontainer. No se sube nada a la biblioteca multimedia de Strapi. Strapi solo guarda una referencia JSON al archivo, que incluye: - `fileId, fileName, folderId`: identificadores para recuperar el archivo - `url`: la URL de la CDN, incluida la plantilla de descarga que hayas elegido - `thumbnailUrl, type, extension, dimensions, size` - `alt, description`y todos los campos personalizados de Kontainer Como el texto alternativo y todos los valores de los campos personalizados viajan con la referencia, los editores no tienen que volver a escribir los metadatos en Strapi, y tu frontend puede leerlos directamente de la respuesta de la API de Strapi. ## Primeros pasos ### 1. Instala el plugin En tu proyecto de Strapi: ``` npm install @kontainer/strapi-plugin ``` Sube a tu repositorio (commit) package.json y package-lock.json para que el plugin se incluya en tu despliegue. Strapi detecta y activa el plugin automáticamente: no hace falta cambiar ningún archivo de configuración. ### 2. Añade el campo de Kontainer a un tipo de contenido En el Content-Type Builder, elige «Custom fields → Kontainer media» (campos personalizados), o añádelo directamente al esquema: `"hero": { "type": "customField", "customField": "plugin::kontainer.media" }` El Content-Type Builder es de solo lectura en producción, así que haz este cambio en tu entorno de desarrollo y despliega el cambio de esquema. ### 3. Compila La interfaz de administración del plugin se compila dentro del paquete de administración. Este paso es obligatorio: sin él, el botón «Choose from Kontainer» no aparece. `npm ci --omit=dev npm run build npm run start` ### 4. Conéctate a Kontainer Ve a «Settings → Kontainer → Configuration» (ajustes, Kontainer, configuración) e introduce la URL de tu Kontainer. Eso es toda la configuración: no hacen falta claves de API ni variables de entorno. Los ajustes se guardan en la base de datos de Strapi, así que tendrás que definirlos una vez por entorno (preproducción y producción por separado). ### 5. Elige archivos En el editor, haz clic en «Choose from Kontainer» (elegir desde Kontainer) en el campo. Navega, busca y filtra tu biblioteca de Kontainer, aplica opcionalmente una plantilla de descarga (recorte, cambio de tamaño, formato) y elige el archivo. Strapi guarda la referencia; la URL de la CDN refleja la plantilla que hayas elegido. ## Opcional: seguimiento del uso de archivos Kontainer puede mostrarte dónde se usa cada archivo en Strapi. En «Settings → Kontainer», haz clic en «Generate» (generar) para crear un token y registra después la URL del endpoint que se muestra, junto con el token, como integración en Kontainer, en Ajustes → Integraciones. Kontainer consulta entonces Strapi e informa del uso en todos los tipos de contenido, incluidos borradores, idiomas (locales), componentes y zonas dinámicas. ## Usar la referencia en tu frontend La referencia vuelve sin cambios de la API de contenido de Strapi: `const page = await fetch(`${STRAPI_URL}/api/pages/${documentId}`).then((r) => r.json()); const { url, alt } = page.data.hero;` Solicita el archivo desde `url`: se sirve desde la CDN de Kontainer. ## Soporte Si necesitas ayuda para configurar el plugin de Strapi, nuestro equipo de soporte te ayudará encantado. Escribe a: [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) - [Français](https://helpdesk.kontainer.com/fr/article/guide-dintegration-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 - [Crear y gestionar automatizaciones](https://helpdesk.kontainer.com/es/article/crear-y-gestionar-automatizaciones/index.md): Configura automatizaciones que mueven, etiquetan, copian o avisan sobre archivos en tu DAM de Kontainer, y gestiónalas desde la vista general de Automations. - [Ajustes de correo](https://helpdesk.kontainer.com/es/article/ajustes-de-correo/index.md): Personaliza los correos predeterminados que envía Kontainer: remitente, asunto y texto de los correos de bienvenida, activación y actualización de permisos, y cómo usar tu propio dominio como remitent… - [Guía del administrador](https://helpdesk.kontainer.com/es/article/guia-del-administrador/index.md): En Kontainer, un administrador es un tipo de usuario con acceso completo. Encuentra aquí la guía y los artículos principales para empezar como administrador. - [Guía de introducción para nuevos administradores](https://helpdesk.kontainer.com/es/article/guia-de-introduccion-para-nuevos-administradores/index.md): Guía de introducción para nuevos administradores de Kontainer: inicio de sesión, estructura, archivos, plantillas de descarga, etiquetado y búsqueda, sección de contacto y acceso de los usuarios.