--- title: "REST-API" description: "Eine HTTP-API für 45 Datei-Konvertierungsrouten, 5 Routen zur Webseitenerfassung und sieben Web-Intelligence-Endpoints. Ein Key, eine Basis-URL, vorsignierte Download-Links zurück." canonical: "https://www.enconvert.com/de/integrations/rest-api" locale: "de" --- Offizielle REST-API # Eine HTTP-API. Jede Konvertierung, eine Basis-URL. Fünfundvierzig Datei-Konvertierungsrouten für Datenformate, Dokumente und Bilder, fünf Routen zur Webseitenerfassung und sieben Web-Intelligence-Endpoints, die Live-Seiten rendern, durchsuchen, extrahieren und überwachen. Alles hängt an api.enconvert.com, und jede Konvertierung antwortet mit einem vorsignierten Download-Link. curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf -H "X-API-Key: sk\_..." -d '{"url":"https://example.com"}' Kopieren Authentifizierung ## Zwei Key-Typen, nur einen Header entfernt. Wähle den Key, der zur Herkunft der Anfrage passt. Beide werden im Dashboard erstellt und widerrufen. ### Private Keys für deinen Server Schicke einen Key, der mit sk\_ beginnt, im X-API-Key-Header. Voller Zugriff auf jeden Endpoint, einschließlich Sync, Async und Batch. Keys werden als SHA-256-Hashes gespeichert, der Klartext wird also nur einmal bei der Erstellung angezeigt und danach nie wieder. `X-API-Key: sk_...` ### Public Keys für den Browser Tausche einen Key, der mit pk\_ beginnt, an POST /v1/auth/token gegen ein kurzlebiges JWT, und schicke es dann als Authorization: Bearer. Public Keys funktionieren nur von den Domains, die du auf die Whitelist setzt, und POST /v1/auth/refresh erneuert das Token, bevor es abläuft. `Authorization: Bearer ` Ein Private Key, der aus einem Browser verwendet wird, wird rundweg abgelehnt. Die API liest den Origin-Header und verweigert sk\_-Keys aus Browser-Umgebungen, sodass ein geleakter Server-Key nicht von einer Seite aus wiederverwendet werden kann. [ Authentifizierungs-Guide lesen ](/docs/authentication.md) Endpoints ## Fünfundvierzig Datei-Konvertierungsrouten, fünf Webseiten-Erfassungen. Sieben weitere fürs Web selbst. Webseiten-Endpoints nehmen einen JSON-Body mit URLs entgegen. Datenformat-, Dokument- und Bild-Endpoints nehmen einen multipart/form-data-Upload entgegen. Die V2-Endpoints nehmen JSON entgegen und teilen sich dieselben Keys und dieselbe Domain-Allowlist, mit eigenen Kontingent-Zählern. 1. 01 ### Webseiten 5 Endpoints Rendere jede URL als PDF, Screenshot oder sauberes Markdown, und fasse eine ganze Website zu einem Dokument zusammen. Batch und Async werden beide unterstützt. `POST /v1/convert/url-to-pdf` 2. 02 ### Datenformate 11 Endpoints JSON zu und von XML, YAML, CSV und TOML, CSV zu und von XML, und Markdown zu HTML. Strukturierte Daten rein, strukturierte Daten raus. `POST /v1/convert/json-to-xml` 3. 03 ### Dokumente zu PDF 13 Endpoints HTML, Markdown, Word, Excel, PowerPoint, die OpenDocument-Familie, Pages und Numbers, alle gerendert zu PDF mit derselben Request-Form. Zwei Sammelrouten machen aus fast jeder Datei PDF oder Markdown. `POST /v1/convert/doc-to-pdf` 4. 04 ### Bildkonvertierungen 21 Endpoints JPEG, PNG, WebP, HEIC und SVG in jeder Kombination, plus PDF zu JPEG. Ein qualitätsbewusster Kompressor hat zusätzlich seine eigene Route. `POST /v1/convert/heic-to-webp` 5. 05 ### Web Intelligence 7 Endpoints perceive, discover, lookup, distill, ingest und watch. Rendere eine Seite, kartiere eine Website, löse eine Entität auf, ziehe strukturierte Felder, baue einbettbare Passagen, und erfahre, wenn sich eine Seite ändert. `POST /v2/perceive` Fehler kommen als JSON mit einem detail-Feld zurück: 401 für einen fehlenden oder ungültigen Key, 402 wenn das monatliche Limit erreicht ist, 403 für eine Domain oder einen Endpoint, den dein Key nicht nutzen darf, und 413 für eine Datei über dem Größenlimit deines Plans. [ Alle Endpoints durchsuchen ](/docs/endpoints.md) In der Praxis ## Eine Anfrage und eine Antwort. Jeder Endpoint folgt derselben Form. Schicke einen Key, bekomm einen vorsignierten Download-Link und die passenden Metadaten zurück. ``` $curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \$ -H "X-API-Key: sk_your_private_key" \$ -H "Content-Type: application/json" \$ -d '{"url": "https://example.com"}'{ "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...", "object_key": "live/files/12345/url-to-pdf/example_20250202_120530123.pdf", "filename": "example_20250202_120530123.pdf", "file_size": 45678, "conversion_time_seconds": 3.21} ``` Darauf aufgebaut ## Eine API, vier Wege hinein. REST ist das Fundament. Jede andere Oberfläche ist ein schlankerer Weg, dieselben Endpoints mit demselben Key zu erreichen. ### Node.js-SDK Typisierte Methoden, Streaming-Downloads, automatische Wiederherstellung nach einem Job-Timeout und eine echte Fehlerhierarchie statt Status-Code-Verzweigungen. Null Laufzeit-Abhängigkeiten, ESM und CJS. [ Auf npm ansehen ](https://www.npmjs.com/package/@enconvert/node-sdk) ### Kommandozeilen-Tool Die ganze API als ein Terminal-Befehl, für Shells, Skripte und CI-Jobs, bei denen ein HTTP-Client mehr Aufwand ist, als die Aufgabe verdient. [ CLI ansehen ](/de/integrations/cli.md) ### n8n-Node Konvertiere, scrape und crawle innerhalb eines Workflows, ohne selbst eine Anfrage zu schreiben oder ein Job-Polling zu handhaben. [ n8n-Node ansehen ](/de/integrations/n8n.md) ### MCP-Server Dieselben Endpoints als Tools bereitgestellt, die dein Agent direkt aufrufen kann, für Claude, Cursor und Windsurf. [ MCP-Server ansehen ](/de/mcp.md) ## Fragen zur API Was ist die Basis-URL für die EnConvert-API? https://api.enconvert.com. Jeder v1- und v2-Endpoint hängt an dieser einen Basis-URL, es gibt also nichts Regionales oder Mandantenspezifisches zu konfigurieren. Wie authentifiziere ich mich? Für Server-zu-Server-Aufrufe schickst du einen Private Key, der mit sk\_ beginnt, im X-API-Key-Header. Für Browser-Aufrufe tauschst du einen Public Key, der mit pk\_ beginnt, an POST /v1/auth/token gegen ein kurzlebiges JWT und schickst es als Authorization: Bearer. Public Keys funktionieren nur von den Domains, die du im Dashboard auf die Whitelist setzt. Was ist der Unterschied zwischen V1 und V2? V1 sind die 45 Datei-Konvertierungsrouten plus 5 Routen zur Webseitenerfassung: Dateien und Webseiten rein, konvertierte Dateien raus. V2 sind sieben Web-Intelligence-Endpoints (perceive, convert, discover, lookup, distill, ingest und watch), die Live-Seiten rendern, durchsuchen, extrahieren und überwachen. Sie nutzen dieselben Keys und dieselbe Domain-Allowlist und werden über getrennte Zähler abgerechnet. Schicke ich eine URL oder lade ich eine Datei hoch? Beides, je nach Endpoint. Die fünf Webseiten-Endpoints nehmen einen JSON-Body mit der URL entgegen. Die Datenformat-, Dokument- und Bild-Endpoints nehmen einen multipart/form-data-Datei-Upload entgegen. Was passiert, wenn ich mein Plan-Limit erreiche? Die API antwortet mit 402 und einem detail-Feld, das die genutzten und erlaubten Zahlen nennt. Ein Batch, der dich über dein verbleibendes Kontingent bringen würde, wird von vornherein abgelehnt statt teilweise verarbeitet, sodass du nie für einen halb fertigen Lauf bezahlst. Gibt es ein offizielles SDK? Ja, @enconvert/node-sdk für Node.js und TypeScript. Es ruft dieselben öffentlichen Endpoints auf, hat null Laufzeit-Abhängigkeiten und liefert sowohl ESM- als auch CJS-Builds, sodass sich SDK-Aufrufe und rohe HTTP-Aufrufe in einer Codebasis frei mischen lassen. ## Starte mit einer Anfrage. Der Quickstart führt dich in drei Schritten durch deine erste Konvertierung, mit Beispielen für cURL, Python und JavaScript. [Quickstart lesen](/docs/quickstart.md)[API-Key holen](/de/dashboard/api-keys)