Cómo se conecta
Una API REST para tus servidores, con claves que no abren el panel y un webhook firmado por cada pieza.
- Claves de API: Las creas desde tu panel, de solo lectura o de lectura y escritura, con vencimiento opcional. Cada clave es de una persona y se revoca en un clic.
- Webhooks firmados: Cada cambio llega a tu servidor con firma HMAC-SHA256: artículos nuevos, reescrituras, títulos y descripciones, enlaces internos y llms.txt. Si tu servidor no contesta, se reintenta durante medio día y nada se pierde.
Cómo funciona
Recibes la pieza lista para tu base de datos y nos dices en qué dirección quedó publicada. Desde ahí la medimos.
- JSON completo: Título, slug sugerido, extracto, idioma, la búsqueda que responde, y el cuerpo en Markdown y en HTML.
- Con cualquier lenguaje: Funciona con tu backend en Node.js, Python, Go o PHP. La referencia trae ejemplos de verificación de firma en Node.js y Python.
Puntos clave y FAQ
¿Cuál es el rate limit de la API?
100 peticiones por minuto y 20 000 por día, por clave. Si te pasas, la respuesta es 429 con Retry-After.
¿Cómo sé cuánto he consumido?
Cada respuesta trae cabeceras con las peticiones que te quedan y con el uso de IA del mes: qué porcentaje de tu plan llevas y cuánto te falta. GET /usage lo da con detalle, y tu panel también. La API está incluida mientras tu suscripción esté activa.
¿Puedo pedir el contenido en Markdown en vez de HTML?
Sí. Cada entrega trae los dos, y al pedirlas con format=markdown o format=html recibes solo el que te sirve: ideal para Next.js, Hugo o Gatsby.
¿Ofrecen SDKs?
Todavía no. La referencia completa está dentro de tu panel, generada desde el propio contrato de la API, con ejemplos en Node.js y Python para verificar la firma de los webhooks.
¿La documentación es pública?
No. La API solo acepta claves de clientes, y su referencia se consulta con tu cuenta, en el panel.