Einführung
Willkommen bei der OptimoCMS-Entwicklerdokumentation. Erfahren Sie, wie Sie Sites, Seiten, Medien und mehr über die REST API, das TypeScript SDK oder die MCP-KI-Integration verwalten.
Was ist OptimoCMS?
OptimoCMS ist eine Multi-Tenant Headless-CMS-Plattform zur Verwaltung von Websites, E-Commerce, Buchungen, Treueprogrammen und mehr — alles über eine einzige API.
Sie können OptimoCMS auf drei Arten nutzen:
| Methode | Wann verwenden |
|---|---|
| REST API | Direkte HTTP-Aufrufe aus jeder Sprache oder Plattform |
| TypeScript SDK | Typsichere Entwicklung in Node.js oder Browser |
| MCP (KI-Tools) | KI-gesteuerte Seitenverwaltung über Cursor, Claude oder Lovable |
Architektur
┌─────────────────┐ ┌──────────────────────────┐
│ Ihre App │────▶│ api.optimocms.com (v1) │
│ (SDK / curl) │◀────│ Cloud Run · europe-west4 │
└─────────────────┘ └────────────┬─────────────┘
│
┌─────────────────┐ ┌────────────▼─────────────┐
│ KI Agent │────▶│ Firestore (Multi-Tenant) │
│ (MCP-Tools) │ │ Storage · CDN │
└─────────────────┘ └──────────────────────────┘- API Gateway — Ein Endpoint für alle Operationen. API-Key-Authentifizierung über
X-Api-KeyHeader. - Multi-Tenant — Jede Site hat eine eindeutige
siteId. Ihr API-Key gewährt nur Zugriff auf Ihre eigenen Sites. - EU-gehostet — Alle Daten werden in der EU gespeichert (europe-west4). DSGVO-konform by design.
Schnelllinks
- Quickstart — Ihr erster API-Aufruf in 5 Minuten
- Authentifizierung — API-Keys, Scopes und Rate Limits
- API-Referenz — Alle Endpoints mit Request/Response-Beispielen
- SDK-Anleitung — TypeScript SDK Installation und Nutzung
- MCP-Integration — KI-Tool-Integration mit Cursor, Claude und Lovable
Jetzt ausprobieren
curl https://api.optimocms.com/v1/sites \
-H "X-Api-Key: ihr_api_key"{
"data": [
{
"id": "site_abc123",
"name": "Mein Restaurant",
"domain": "meinrestaurant.de",
"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" }
}