API y webhooks para integrar tu blog en cualquier web o app
La API de Blogenia es de lectura: con una clave devuelve tus blogs y artículos en JSON, HTML o Markdown, y un webhook firmado te avisa cada vez que se publica un artículo. No crea artículos.
Qué puedes hacer con la API
Puedes leer tus blogs, tus artículos publicados y sus estadísticas, y consultar los datos de tu cuenta, para mostrar el blog en tu propia web o montar un panel. La referencia completa está en la documentación para desarrolladores.
Claves y permisos (scopes)
Las claves empiezan por pk_live_ y se crean en el panel. Cada una lleva solo los permisos que marques: content:read para el contenido, stats:read para las estadísticas y account:read para los datos de cuenta, este último solo para el propietario.
Formatos: JSON, HTML y Markdown
Un artículo se puede pedir como JSON, con el HTML y el Markdown incluidos, como fragmento HTML listo para pintar o como Markdown. Las preguntas frecuentes viajan en el JSON.
Webhook article.published firmado con HMAC
Hoy hay un único evento, article.published. Cada entrega va firmada con HMAC y, si tu servidor no responde bien, se reintenta hasta 5 veces con una espera creciente.
Límites por plan
Starter admite 60 peticiones por minuto por clave y Pro, 300. Al superarlo la API responde 429. El plan Free no incluye acceso por API.
Preguntas frecuentes
¿Puedo crear artículos por API?
No. La API es de lectura. Los artículos se generan desde el panel o con el piloto automático.
¿Qué eventos de webhook hay?
Hoy, uno: article.published, firmado y con reintentos.
¿Hay límites?
Sí, por plan: 60 peticiones por minuto en Starter y 300 en Pro.
Pruébalo con tu web
Empieza gratis, sin tarjeta. Revisas cada artículo antes de que se publique.