Récupérer un article publié
Remplacez cms.example.com par l’adresse du CMS et 42 par l’identifiant d’un article publié. Utilisez la réponse pour afficher l’article sur votre site. En cas de réponse 404, vérifiez l’identifiant et l’état de publication.
curl -fsS "https://cms.example.com/v1/article/42?format=json"Choisir un format de réponse
Les articles peuvent être lus en Markdown, en HTML stocké ou sous forme de blocs JSON. Choisissez format=markdown, format=html ou format=json selon votre moteur de rendu. Si vous écrivez via l’API, envoyez le corps de l’article en HTML. Utilisez la pagination des routes de liste pour récupérer tous les éléments.
Afficher les métadonnées SEO et le sitemap
Utilisez les données SEO résolues et le sitemap indiqués dans la référence Intégration de votre instance. Affichez l’URL canonique, le titre et la description sur la page publique.
Utilisez l’identifiant renvoyé avec le contenu dans la requête SEO. La route du sitemap renvoie du JSON paginé. Récupérez toutes les pages et produisez le sitemap XML depuis votre site en excluant les entrées marquées noindex.
curl -fsS "https://cms.example.com/v1/article/42/seo"
curl -fsS "https://cms.example.com/v1/site/journal/sitemap?page=1&size=100"Authentifier les requêtes côté serveur
Les lectures publiques sont accessibles sans clé. Pour les routes protégées compatibles, créez une clé API nommée dans une session vérifiée, stockez-la dans les secrets du serveur et envoyez-la avec Authorization: Bearer rcms_…. Une clé hérite des permissions de son créateur. Révoquez-la lorsqu’elle ne sert plus et ne l’incluez pas dans le code du navigateur.
Trouver la référence API de votre version
Ouvrez Intégration dans le backoffice pour consulter les routes, l’authentification, les paramètres et les exemples de votre version. Votre CMS sert aussi /openapi.json, /llms.txt et /llms-full.txt. Utilisez ces fichiers pour générer un client ou documenter une intégration propre à une version.
Connecter un client MCP
Lancez l’exécutable facultatif renewcms-mcp comme serveur stdio depuis votre client MCP. Fournissez-lui l’URL du CMS et une clé API dédiée dans les variables d’environnement du client. Si nécessaire, compilez l’exécutable depuis les sources de votre version avec task build:mcp. Créez la clé dans Intégration → Clés API et renseignez RENEWCMS_URL et RENEWCMS_API_KEY comme ci-dessous.
{
"mcpServers": {
"renewcms": {
"command": "/path/to/renewcms-mcp",
"env": {
"RENEWCMS_URL": "https://cms.example.com",
"RENEWCMS_API_KEY": "rcms_..."
}
}
}
}