API pour développeurs

L'API Optimocms vous permet de contrôler votre CMS depuis des outils et systèmes externes. Par exemple : • Un tableau de bord personnalisé affichant les données de tous vos sites • Un système externe qui met à jour automatiquement les produits ou le contenu • Des outils IA comme Lovable, Cursor ou Claude qui créent et publient des pages • Des intégrations avec Zapier, Make ou n8n pour l'automatisation L'API utilise des requêtes HTTP standard (GET, POST, PUT, DELETE) et renvoie du JSON. Consultez la documentation technique complète sur developers.optimocms.com.

Allez dans Paramètres → Clés API et suivez ces étapes : 1. Cliquez sur 'Nouvelle clé API' 2. Donnez un nom reconnaissable à la clé (ex. 'Intégration Lovable') 3. Choisissez les permissions : lecture seule, écriture, fonctions IA, publication 4. Optionnel : limitez la clé à des sites spécifiques 5. Cliquez sur 'Créer' La clé API n'est affichée qu'une seule fois. Copiez-la et conservez-la en sécurité — vous ne pourrez plus la consulter.

Ajoutez votre clé API en tant qu'en-tête à chaque requête : X-Api-Key: omc_votre_clé_api Sans clé valide, vous recevrez une erreur 401.

L'API a des limites par plan pour une utilisation équitable : • Starter (29 €) : 1 000 appels API/mois, 500 appels MCP, 10 req/min • Professional (79 €) : 5 000 appels API/mois, 2 500 appels MCP, 20 req/min, 100K tokens IA • Agency (199 €) : 50 000 appels API/mois, 25 000 appels MCP, 60 req/min, 500K tokens IA Fonctions IA (générer, traduire) : maximum 2 par minute. Publication : refroidissement de 5 minutes par site. En cas de dépassement, vous recevez une erreur 429 avec un en-tête Retry-After.

L'API donne accès à : • Sites web — Liste, détails, publication • Pages — Lire, créer, mettre à jour • Médias — Récupérer et rechercher des fichiers • IA — Générer des pages, traduire, améliorer le contenu • Réservations — Disponibilité, réservations • Boutique — Produits, commandes, codes de réduction • Fidélité — Points, récompenses, membres • Analyses — Statistiques de visiteurs Consultez la référence API complète avec des exemples de requêtes/réponses pour chaque endpoint.

Récupérer toutes les pages d'un site : GET /v1/sites/{siteId}/pages X-Api-Key: omc_votre_clé Créer une nouvelle page : POST /v1/sites/{siteId}/pages X-Api-Key: omc_votre_clé Content-Type: application/json {"title": "Contact", "slug": "contact"} Traduire une page en allemand : POST /v1/sites/{siteId}/ai/translate X-Api-Key: omc_votre_clé {"pageId": "page_abc", "targetLanguage": "de"}

L'API Optimocms suit une politique de versioning claire pour rendre les breaking changes prévisibles. • Versions : l'API est versionnée via le chemin URL (ex. /v1/). Les breaking changes ne sont introduits que dans une nouvelle version majeure (ex. /v2/). • Les ajouts non-breaking (nouveaux champs, nouveaux endpoints) sont ajoutés à la version existante. • Dépréciation : lorsqu'un endpoint devient obsolète, vous recevez deux en-têtes HTTP standard : – Sunset : la date à laquelle l'endpoint sera supprimé. – Deprecation : true — indique que l'endpoint est déprécié. – Link : pointe vers la documentation de migration. • Délai minimum de préavis : vous avez toujours au moins 90 jours pour migrer vers l'endpoint de remplacement. Vérifiez régulièrement si vos réponses contiennent des en-têtes Sunset afin de pouvoir migrer à temps.

Toutes les modifications apportées à l'API sont suivies ici. 26 mai 2026 — v1 (version actuelle) • Première publication publique de l'API REST • Endpoints : Sites, Pages, Médias, IA, Réservations, Boutique, Fidélité, Analyses • Authentification via l'en-tête X-Api-Key • Limitation de débit par plan • En-têtes Sunset et Deprecation introduits pour les dépréciations futures Consultez le journal des modifications API complet sur les developer docs pour l'aperçu le plus récent.