La API pública de DraftIn

DraftIn es un CMS headless para quien escribe. Modelas el contenido, escribes en el editor y publicas — y la API pública entrega ese contenido ya publicado a cualquier front-end: un sitio en Astro o Next.js, una app nativa, una newsletter o un webhook de revalidación.

Esta es la referencia oficial de la capa pública de la plataforma: la interfaz de lectura de contenido que los sitios de los clientes consumen usando una clave de API. Toda la documentación a continuación cubre solo los endpoints destinados al consumo por aplicaciones de terceros — nada de la administración interna del panel.

En 30 segundos

Cada petición apunta a la base URL de producción y lleva tu clave en la cabecera X-API-Key. Así se listan los tres posts más recientes de un blog:

curl https://api.draftin.io/public/posts?limit=3 \
  -H "X-API-Key: $DRAFTIN_API_KEY"

const res = await fetch("https://api.draftin.io/public/posts?limit=3", {
  headers: { "X-API-Key": process.env.DRAFTIN_API_KEY },
});

const { data: posts } = await res.json();
console.log(posts);

La respuesta es un envelope JSON { success, data }, con el array de objetos Post en data. A partir de ahí, renderízalo como quieras — DraftIn no impone tema ni capa de presentación.

Por dónde empezar

Si es tu primera integración, sigue este camino:

Principios de la API

• REST sobre HTTPS. Rutas predecibles, verbos HTTP estándar y respuestas JSON.
• Alcance por blog. Cada clave de API pertenece a un blog y solo ve el contenido de ese blog.
• Solo contenido publicado. Los endpoints públicos devuelven solo elementos con estado PUBLISHED — los borradores y programados nunca se filtran.
• Sin estado de sesión. No hay login ni cookies: la autenticación es por clave en cada petición.
• Respuestas en envelope. Los éxitos llegan como { success, data, meta? } y los errores como { success: false, error } con un código estable — consulta Formato de las respuestas.