Introducción
Bienvenido a la documentación para desarrolladores de OptimoCMS. Aprende a gestionar sitios, páginas, medios y más a través de la API REST, el SDK TypeScript o la integración MCP IA.
¿Qué es OptimoCMS?
OptimoCMS es una plataforma CMS headless multi-tenant para gestionar sitios web, comercio electrónico, reservas, programas de fidelización y más — todo a través de una única API.
Puedes acceder a OptimoCMS de tres formas:
| Método | Cuándo usar |
|---|---|
| API REST | Llamadas HTTP directas desde cualquier lenguaje o plataforma |
| SDK TypeScript | Desarrollo tipado en Node.js o navegador |
| MCP (herramientas IA) | Gestión de sitios con IA vía Cursor, Claude o Lovable |
Arquitectura
┌─────────────────┐ ┌──────────────────────────┐
│ Tu app │────▶│ api.optimocms.com (v1) │
│ (SDK / curl) │◀────│ Cloud Run · europe-west4 │
└─────────────────┘ └────────────┬─────────────┘
│
┌─────────────────┐ ┌────────────▼─────────────┐
│ Agente IA │────▶│ Firestore (multi-tenant) │
│ (herramientas │ │ Storage · CDN │
│ MCP) │ └──────────────────────────┘
└─────────────────┘- API Gateway — Un solo endpoint para todas las operaciones. Autenticación por clave API vía cabecera
X-Api-Key. - Multi-tenant — Cada sitio tiene un
siteIdúnico. Tu clave API solo da acceso a tus propios sitios. - Alojado en la UE — Todos los datos se almacenan en la UE (europe-west4). Cumple con el RGPD por diseño.
Enlaces rápidos
- Quickstart — Tu primera llamada API en 5 minutos
- Autenticación — Claves API, scopes y límites de velocidad
- Referencia API — Todos los endpoints con ejemplos
- Guía SDK — Instalación y uso del SDK TypeScript
- Integración MCP — Integración de herramientas IA con Cursor, Claude y Lovable
Pruébalo ahora
curl https://api.optimocms.com/v1/sites \
-H "X-Api-Key: tu_clave_api"{
"data": [
{
"id": "site_abc123",
"name": "Mi Restaurante",
"domain": "mirestaurante.es",
"status": "published",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-05-20T14:22:00Z"
}
],
"pagination": { "total": 1, "limit": 20, "nextCursor": null },
"meta": { "requestId": "req_xyz789", "timestamp": "2026-05-26T12:00:00Z" }
}