Configuración de Contentful: Creación de Cuenta y API Tokens

Curso de Next.js: Sitios Estáticos y Jamstack

Clase 4 de 19

Clase 4 / 19

Recursos

Tener un CMS listo y conectado con tu aplicación es el primer paso para construir proyectos modernos con contenido dinámico. Contentful es una plataforma de gestión de contenido que permite almacenar, organizar y servir datos a través de una API, y configurarlo correctamente garantiza que tu app pueda consumir información de forma segura y eficiente.

¿Cómo crear una cuenta gratuita en Contentful?

El proceso inicia en Contentful.com, seleccionando la opción Get Started y luego Start Building [0:27]. Al registrarte solo necesitas completar datos básicos como nombre, email y contraseña. Los campos adicionales como rol o plataforma son informativos y se usan con fines de marketing, así que lo verdaderamente relevante es tu email y contraseña.

Una vez creada la cuenta, Contentful ofrece dos tipos de wizards para facilitar el inicio. Para efectos prácticos, cualquiera de las dos opciones funciona. La plataforma generará automáticamente un espacio (así lo denomina Contentful) con datos de ejemplo listos para usar.

¿Qué es un espacio en Contentful y cómo limpiarlo?

Un espacio es el contenedor principal donde vive todo tu contenido: modelos, entradas y configuraciones. Al crearse por primera vez, Contentful lo llena con datos de muestra visibles en las pestañas Content Model y Content [1:29].

Si deseas partir de cero, puedes eliminarlo desde Settings > General Settings y seleccionar la opción de borrar el espacio completo junto con su contenido [1:44]. Después, creas uno nuevo eligiendo:

La cuenta gratuita.
El tipo web app.
Un nombre descriptivo para tu proyecto.
La opción de espacio completamente vacío [2:08].

Esto te deja con un dashboard limpio, sin modelos de contenido ni entradas previas, ideal para importar datos propios.

¿Cómo obtener los tokens y API keys necesarios?

Con el espacio creado, el siguiente paso es generar las credenciales que autorizarán a tu aplicación para leer y gestionar contenido. Dirígete a Settings > API Keys [2:38].

¿Qué diferencia hay entre Content Delivery y Content Management Token?

Contentful maneja dos tipos de tokens con propósitos distintos:

Content Delivery API key: permite a tu aplicación leer contenido publicado. Se crea en la pestaña Content Delivery / Preview Tokens. Al generarla obtienes dos datos fundamentales: el Space ID (identificador único del espacio) y la API key de lectura [2:50].
Content Management Token: otorga permisos para escribir e importar contenido en tu espacio. Se genera desde la pestaña Content Management Tokens [3:17]. Este token es el que se utiliza para ejecutar importaciones masivas de datos con herramientas de línea de comandos.

Al crear la Content Delivery API key, asigna un nombre descriptivo como "web application" y una descripción que identifique el proyecto, por ejemplo "Next.js" [2:44]. Guarda los cambios y anota el Space ID y la API key.

Para el Content Management Token, genera uno nuevo con un nombre como "importer CLI" [3:24]. Una vez generado, cópialo y guárdalo de inmediato, ya que Contentful solo lo muestra una vez. Este token será indispensable para importar contenido de forma automatizada.

¿Cuáles son las opciones si ya tienes una cuenta existente?

Si ya contabas con una cuenta de Contentful antes, tienes dos caminos [0:15]:

Usar tu contenido actual: adaptar lo que ya tienes en tu espacio al proyecto del curso.
Borrar el espacio e importar contenido nuevo: esta opción resulta más sencilla porque el proyecto y las lecciones están diseñados en torno a un conjunto de datos específico que se proporciona listo para importar.

Con los tokens guardados y el espacio vacío, Contentful queda preparado para recibir datos mediante un importador que, con una sola línea de código, poblará tu CMS con todo el contenido necesario. ¿Ya tienes tus credenciales listas? Comparte en los comentarios si optaste por usar tu propio contenido o por importar el contenido del curso.