Introductie
OptimoCMS developer docs — beheer sites, pagina's, media, ecommerce en boekingen via REST API, TypeScript SDK of MCP AI-integratie voor Cursor en Claude.
Wat is OptimoCMS?
OptimoCMS is een multi-tenant headless CMS platform waarmee je websites, ecommerce, boekingen, loyaliteitsprogramma's en meer beheert — allemaal via één API.
Je kunt OptimoCMS op drie manieren benaderen:
| Methode | Wanneer gebruiken |
|---|---|
| REST API | Directe HTTP calls vanuit elke taal of platform |
| TypeScript SDK | Type-safe ontwikkeling in Node.js of browser |
| MCP (AI tools) | AI-gestuurd sitebeheer via Cursor, Claude of Lovable |
Architectuur
┌─────────────────┐ ┌──────────────────────────┐
│ Je applicatie │────▶│ api.optimocms.com (v1) │
│ (SDK / curl) │◀────│ Cloud Run · europe-west4 │
└─────────────────┘ └────────────┬─────────────┘
│
┌─────────────────┐ ┌────────────▼─────────────┐
│ AI Agent │────▶│ Firestore (multi-tenant) │
│ (MCP tools) │ │ Storage · CDN │
└─────────────────┘ └──────────────────────────┘- API Gateway — Eén endpoint voor alle operaties. API key authenticatie via
X-Api-Keyheader. - Multi-tenant — Elke site heeft een uniek
siteId. Je API key geeft alleen toegang tot je eigen sites. - EU-hosted — Alle data wordt opgeslagen in de EU (europe-west4). GDPR-compliant by design.
Wat kun je ermee?
| Module | Beschrijving | Endpoints |
|---|---|---|
| Sites | Aanmaken en beheren van websites | GET /v1/sites |
| Pagina's | CRUD + visuele editor data | GET/POST/PUT/DELETE /v1/sites/{siteId}/pages |
| Media | Afbeeldingen, video's, documenten uploaden | GET/POST /v1/sites/{siteId}/media |
| AI | Site generatie, vertaling, content assist | POST /v1/sites/{siteId}/ai/* |
| Ecommerce | Producten, bestellingen, coupons | GET/POST /v1/sites/{siteId}/shop/* |
| Boekingen | Afspraken plannen en beheren | GET/POST /v1/sites/{siteId}/booking/* |
| Loyaliteit | Punten verdienen en inwisselen | POST /v1/sites/{siteId}/loyalty/* |
| Webhooks | Realtime events ontvangen | GET/POST /v1/sites/{siteId}/webhooks |
| Analytics | Bezoekers en pageviews | GET /v1/sites/{siteId}/analytics |
| Push | Push notificatie campagnes | POST /v1/sites/{siteId}/push/campaign |
Snelle links
- Quickstart — Je eerste API call in 5 minuten
- Authenticatie — API keys, scopes en rate limits
- API Referentie — Alle endpoints met request/response voorbeelden
- SDK Gids — TypeScript SDK installatie en gebruik
- MCP Integratie — AI tool integratie met Cursor, Claude en Lovable
Probeer het direct
curl https://api.optimocms.com/v1/sites \
-H "X-Api-Key: jouw_api_key"{
"data": [
{
"id": "site_abc123",
"name": "Mijn Restaurant",
"domain": "mijnrestaurant.nl",
"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" }
}