Passer au contenu principal

Vue d’ensemble

L’API REST de Web2MD vous permet de convertir n’importe quelle page web ou HTML brut en Markdown propre, de façon programmatique. Utilisez-la pour créer des pipelines, automatiser l’ingestion de contenu ou intégrer Web2MD dans vos propres outils.
L’API REST nécessite un plan PRO. Générez votre clé API depuis le tableau de bord Web2MD.

Spécifications lisibles par machine

Utilisez la spécification OpenAPI pour générer automatiquement des SDK clients ou l’importer dans des outils comme Postman, Swagger UI, ou des frameworks d’agents IA.

Authentification

Toutes les requêtes doivent inclure votre clé API dans l’en-tête Authorization :
Les clés API sont préfixées par w2m_ et sont liées à votre compte.

Point de terminaison

POST https://web2md.org/api/v1/convert

Corps de la requête

Fournissez soit url, soit html, mais pas les deux. La requête échouera avec une erreur 400 si les deux sont présents ou si aucun n’est fourni.

Options

Réponse

Une réponse réussie retourne :

Limites de débit

Les requêtes API sont limitées à 60 requêtes par minute par clé API. Si vous dépassez cette limite, l’API retourne un code de statut 429. Attendez la réinitialisation de la fenêtre avant de réessayer.

Réponses d’erreur

Toutes les réponses d’erreur suivent ce format :

Exemples

Convertir une URL avec curl

Convertir du HTML brut avec curl

JavaScript (fetch)

Stockez votre clé API dans une variable d’environnement plutôt que de la coder en dur. Par exemple, utilisez process.env.WEB2MD_API_KEY dans Node.js.