API para desarrolladores

La API de Optimocms te permite controlar tu CMS desde herramientas y sistemas externos. Por ejemplo: • Un panel personalizado que muestra datos de todos tus sitios web • Un sistema externo que actualiza automáticamente productos o contenido • Herramientas de IA como Lovable, Cursor o Claude que crean y publican páginas • Integraciones con Zapier, Make o n8n para automatización La API utiliza solicitudes HTTP estándar (GET, POST, PUT, DELETE) y devuelve JSON. Consulta la documentación técnica completa en developers.optimocms.com.

Ve a Configuración → Claves API y sigue estos pasos: 1. Haz clic en 'Nueva clave API' 2. Dale un nombre reconocible a la clave (ej. 'Integración Lovable') 3. Elige los permisos: solo lectura, escritura, funciones IA, publicar 4. Opcional: restringe la clave a sitios web específicos 5. Haz clic en 'Crear' La clave API se muestra solo una vez. Cópiala y guárdala de forma segura — no podrás verla de nuevo.

Añade tu clave API como encabezado en cada solicitud: X-Api-Key: omc_tu_clave_api Sin una clave válida recibirás un error 401.

La API tiene límites por plan para un uso justo: • Starter (29 €): 1.000 llamadas API/mes, 500 llamadas MCP, 10 sol/min • Professional (79 €): 5.000 llamadas API/mes, 2.500 llamadas MCP, 20 sol/min, 100K tokens IA • Agency (199 €): 50.000 llamadas API/mes, 25.000 llamadas MCP, 60 sol/min, 500K tokens IA Funciones IA (generar, traducir): máximo 2 por minuto. Publicar: enfriamiento de 5 minutos por sitio web. Al excederlos recibes un error 429 con un encabezado Retry-After.

La API proporciona acceso a: • Sitios web — Lista, detalles, publicar • Páginas — Leer, crear, actualizar • Medios — Recuperar y buscar archivos • IA — Generar páginas, traducir, mejorar contenido • Reservas — Disponibilidad, reservaciones • Tienda — Productos, pedidos, códigos de descuento • Fidelidad — Puntos, recompensas, miembros • Análisis — Estadísticas de visitantes Consulta la referencia API completa con ejemplos de solicitudes/respuestas para cada endpoint.

Obtener todas las páginas de un sitio web: GET /v1/sites/{siteId}/pages X-Api-Key: omc_tu_clave Crear una nueva página: POST /v1/sites/{siteId}/pages X-Api-Key: omc_tu_clave Content-Type: application/json {"title": "Contacto", "slug": "contacto"} Traducir una página al alemán: POST /v1/sites/{siteId}/ai/translate X-Api-Key: omc_tu_clave {"pageId": "page_abc", "targetLanguage": "de"}

La API de Optimocms sigue una política de versionado clara para hacer los breaking changes predecibles. • Versiones: la API se versiona a través de la ruta URL (ej. /v1/). Los breaking changes solo se introducen en una nueva versión principal (ej. /v2/). • Las adiciones no-breaking (nuevos campos, nuevos endpoints) se añaden a la versión existente. • Depreciación: cuando un endpoint queda obsoleto, recibes dos encabezados HTTP estándar: – Sunset: la fecha en que el endpoint será eliminado. – Deprecation: true — indica que el endpoint está depreciado. – Link: apunta a la documentación de migración. • Período mínimo de aviso: siempre tienes al menos 90 días para migrar al endpoint de reemplazo. Verifica regularmente si tus respuestas contienen encabezados Sunset para poder migrar con tiempo.

Todos los cambios en la API se registran aquí. 26 de mayo de 2026 — v1 (versión actual) • Primera publicación pública de la API REST • Endpoints: Sitios, Páginas, Medios, IA, Reservas, Tienda, Fidelidad, Análisis • Autenticación mediante encabezado X-Api-Key • Limitación de velocidad por plan • Encabezados Sunset y Deprecation introducidos para depreciaciones futuras Consulta el registro de cambios de la API completo en los developer docs para la visión más actualizada.