API voor ontwikkelaars

De Optimocms API stelt je in staat om je CMS te bedienen vanuit externe tools en systemen. Denk aan: • Een eigen dashboard dat gegevens van al je websites toont • Een extern systeem dat automatisch producten of content bijwerkt • AI-tools zoals Lovable, Cursor of Claude die pagina's aanmaken en publiceren • Koppelingen met Zapier, Make of n8n voor automatisering De API werkt met standaard HTTP-verzoeken (GET, POST, PUT, DELETE) en retourneert JSON. Bekijk de volledige technische documentatie op developers.optimocms.com.

Ga naar Instellingen → API Keys en volg deze stappen: 1. Klik op 'Nieuwe API key' 2. Geef de key een herkenbare naam (bijv. 'Lovable integratie') 3. Kies de rechten: alleen lezen, schrijven, AI-functies, publiceren 4. Optioneel: beperk de key tot specifieke websites 5. Klik op 'Aanmaken' De API key wordt eenmalig getoond. Kopieer en bewaar deze veilig — je kunt hem niet opnieuw bekijken.

Voeg bij elk verzoek je API key toe als header: X-Api-Key: omc_jouw_api_key_hier Zonder geldige key ontvang je een 401-foutmelding.

De API heeft limieten per plan om eerlijk gebruik te garanderen: • Starter (€39): 1.000 API calls/maand, 500 MCP calls, 10 req/min • Professional (€79): 5.000 API calls/maand, 2.500 MCP calls, 20 req/min, 100K AI tokens • Agency (€199): 50.000 API calls/maand, 25.000 MCP calls, 60 req/min, 500K AI tokens AI-functies (genereren, vertalen): maximaal 2 per minuut. Publiceren: cooldown van 5 minuten per website. Bij overschrijding ontvang je een 429-foutmelding met een Retry-After header.

De API biedt toegang tot: • Websites — Lijst, details, publiceren • Pagina's — Lezen, aanmaken, bijwerken • Media — Bestanden ophalen en doorzoeken • AI — Pagina's genereren, vertalen, content verbeteren • Boekingen — Beschikbaarheid, reserveringen • Webshop — Producten, bestellingen, kortingscodes • Loyaliteit — Punten, beloningen, leden • Analytics — Bezoekersstatistieken Bekijk de volledige API reference met request/response voorbeelden voor elk endpoint.

Alle pagina's van een website ophalen: GET /v1/sites/{siteId}/pages X-Api-Key: omc_jouw_key Een nieuwe pagina aanmaken: POST /v1/sites/{siteId}/pages X-Api-Key: omc_jouw_key Content-Type: application/json {"title": "Contact", "slug": "contact"} Een pagina vertalen naar het Duits: POST /v1/sites/{siteId}/ai/translate X-Api-Key: omc_jouw_key {"pageId": "page_abc", "targetLanguage": "de"}

De Optimocms API volgt een helder versioning-beleid om breaking changes voorspelbaar te maken. • Versies: de API is geversioned via het URL-pad (bijv. /v1/). Breaking changes worden alleen in een nieuwe major versie geïntroduceerd (bijv. /v2/). • Niet-breaking toevoegingen (nieuwe velden, nieuwe endpoints) worden toegevoegd aan de bestaande versie. • Deprecation: wanneer een endpoint verouderd raakt, ontvang je twee standaard HTTP-headers: – Sunset: de datum waarop het endpoint wordt verwijderd. – Deprecation: true — geeft aan dat het endpoint afgeraden wordt. – Link: verwijst naar de migratiedocumentatie. • Minimum opzegtermijn: je hebt altijd minstens 90 dagen om te migreren naar het vervangende endpoint. Controleer regelmatig of je responses Sunset-headers bevatten, zodat je ruim op tijd kunt migreren.

Alle wijzigingen aan de API worden hier bijgehouden. 26 mei 2026 — v1 (huidige versie) • Eerste publieke release van de REST API • Endpoints: Sites, Pagina's, Media, AI, Boekingen, Webshop, Loyaliteit, Analytics • Authenticatie via X-Api-Key header • Rate limiting per plan • Sunset- en Deprecation-headers geïntroduceerd voor toekomstige deprecaties Bekijk de volledige API Changelog op de developer docs voor het meest actuele overzicht.