Documentation de l'API Markdodo

Guide complet pour utiliser l'API de gestion de pages Markdown

Présentation

L'API Markdodo permet de gérer l'ensemble de vos pages Markdown de manière programmatique. Elle offre des endpoints REST pour créer, lire, modifier et supprimer des pages, ainsi que pour organiser les menus, les liens et les images. Le contenu des pages est rédigé en Markdown, avec des syntaxes étendues propres à Markdodo.

Endpoints disponibles

Méthode	Endpoint	Description
`GET`	`/api/pages`	Lister toutes les pages du site
`GET`	`/api/pages/markdown/[slug-page]`	Récupérer le contenu Markdown brut d'une page
`POST`	`/api/pages`	Créer une nouvelle page
`PATCH`	`/api/pages`	Modifier le contenu d'une page
`DELETE`	`/api/pages`	Supprimer une page
`POST`	`/api/images/formData`	Héberger une image depuis une URL
`POST`	`/api/images/base64`	Héberger une image en base64

Consultez la page Endpoints pour le détail de chaque méthode.

Sommaire

Guide pour agents IA - Résumé complet de l'API pour les agents IA
Authentification - Configuration de la clé API et du header Bearer
Endpoints - Détail des méthodes GET, POST, PATCH et DELETE
Spécificités - Liens, images, menu et Markdown étendu

Base URL

Les endpoints de l'API Markdodo sont accessibles depuis :

https://markdodo.com/api

Les routes complètes dépendent de la ressource utilisée : pages, Markdown brut ou images.

L'authentification se fait via un header Authorization: Bearer <votre_clé_api>.

Lecture du Markdown brut

L'endpoint GET /api/pages retourne uniquement les métadonnées des pages. Pour récupérer le contenu Markdown brut d'une page, le slug de la page est obligatoire dans l'URL :

GET /api/pages/markdown/[slug-page]

Exemple :

GET /api/pages/markdown/documentation

Pour la page d'accueil, utilisez le slug vide selon la convention de votre intégration.

Format des réponses

L'API retourne des réponses au format JSON. Les réponses de succès contiennent les données de la page ou de la ressource demandée, et les erreurs sont retournées avec un message explicatif.