Zum Hauptinhalt springen

Übersicht

Die Web2MD REST API ermöglicht es Ihnen, jede Webseite oder rohes HTML programmgesteuert in sauberes Markdown zu konvertieren. Nutzen Sie sie, um Pipelines aufzubauen, die Inhaltsaufnahme zu automatisieren oder Web2MD in Ihre eigenen Tools zu integrieren.
Die REST API erfordert einen PRO-Plan. Erstellen Sie Ihren API-Schlüssel im Web2MD-Dashboard.

Maschinenlesbare Spezifikationen

Verwenden Sie die OpenAPI-Spezifikation, um Client-SDKs automatisch zu generieren oder sie in Tools wie Postman, Swagger UI oder AI-Agent-Frameworks zu importieren.

Authentifizierung

Jede Anfrage muss Ihren API-Schlüssel im Authorization-Header enthalten:
API-Schlüssel beginnen mit dem Präfix w2m_ und sind an Ihr Konto gebunden.

Endpunkt

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

Request Body

Geben Sie entweder url oder html an, nicht beides. Die Anfrage schlägt mit einem 400-Fehler fehl, wenn beide vorhanden sind oder keines von beiden angegeben wird.

Optionen

Antwort

Eine erfolgreiche Antwort liefert:

Ratenbegrenzung

API-Anfragen sind auf 60 Anfragen pro Minute pro API-Schlüssel begrenzt. Bei Überschreitung des Limits gibt die API einen 429-Statuscode zurück. Warten Sie das Reset-Fenster ab, bevor Sie es erneut versuchen.

Fehlerantworten

Alle Fehlerantworten folgen diesem Format:

Beispiele

URL mit curl konvertieren

Rohes HTML mit curl konvertieren

JavaScript (fetch)

Speichern Sie Ihren API-Schlüssel in einer Umgebungsvariable, anstatt ihn fest im Code zu hinterlegen. Verwenden Sie zum Beispiel process.env.WEB2MD_API_KEY in Node.js.