Ein Aufruf, eine Datei, ein Ergebnis
Die Konvertierungs-API besteht aus zwei Endpunkten: der Konvertierung und der Tabelle der unterstützten Paare. Kostenlos, ohne Schlüssel und ohne Konto — geschützt durch ein Ratenlimit.
Sofort ausprobieren
Senden Sie eine beliebige Datei bis 10 MB als Multipart-HTTP, mit dem Ziel in `to`:
curl -X POST https://api.convertchester.com/v1/convert \ -F "file=@logo.png" \ -F "to=jpeg"
Aufbau der JSON-Antwort
Eine strukturelle Ablehnung liefert HTTP 200 OK mit status: "refused" und einer Begründung: Das Urteil steht im Antwortkörper. HTTP-4xx-Fehler betreffen nur die Anfrage selbst — leere Datei, zu groß, unbekanntes Ziel.
{
"status": "converted",
"document": {
"sha256": "30f35a4b89f071a82f57ed9834fd77df...",
"bytes": 80
},
"source": "png",
"target": "jpeg",
"result": {
"filename": "logo.jpg",
"media_type": "image/jpeg",
"sha256": "6a7570d4efd75f9f3d9780e044240c88...",
"bytes": 644,
"content": "/9j/4AAQSkZJRgABAgAAAQAB…"
}
}Verfügbare Endpunkte
| Methode | Pfad | Rolle |
|---|---|---|
| POST | /v1/convert | Eine Datei in das gewünschte Format umwandeln |
| GET | /v1/formats | Die Tabelle der unterstützten Paare — berechnet, nie von Hand geschrieben |
| GET | /v1/usage | Nutzung des aktuellen Kontos (Schlüssel erforderlich) |
| GET | /v1/openapi | Die OpenAPI-Spezifikation, von der API selbst ausgeliefert |
Nützliche Header
Accept-Language wählt die Sprache der lesbaren Meldungen (fr oder en) — Codes werden nie übersetzt. Idempotency-Key bindet einen Schlüssel an den Fingerabdruck der eingereichten Datei: Ihn mit derselben Datei zu wiederholen ist folgenlos, mit einer anderen liefert er 409 idempotency_conflict.
Was gezählt wird
Mit API-Schlüssel ist die gezählte Einheit die eindeutige Datei, identifiziert durch ihren SHA-256 — nicht der HTTP-Aufruf. Dieselbe Datei erneut einzureichen ist sieben Tage lang kostenlos, und eine Ablehnung wird nie gezählt: Gezählt wird nur, was erzeugt wurde.