Eine Datei umwandeln
Ein Endpunkt erledigt die Arbeit. Senden Sie eine Datei und ein Zielformat und erhalten Sie einen Auftrag zurück — fertig, wenn es schnell ging, sonst eingereiht.
Authentifizierung
Alle Endpunkte außer dem Formatkatalog benötigen einen API-Schlüssel, gesendet als Bearer-Token. Erstellen Sie einen in Ihrem Konto auf der Seite „Automatisieren“; er wird einmal angezeigt und nur als Hash gespeichert — ein verlorener Schlüssel lässt sich also nicht wiederherstellen, stellen Sie stattdessen einen neuen aus.
Der API-Zugang gehört zum Plus-Tarif. Ein Schlüssel eines Kontos ohne diesen Tarif wird mit NOT_ENTITLED abgelehnt.
Authorization: Bearer rlv_your_key_hereDie Anfrage
POST https://rework.live/api/v1/convert, als multipart/form-data, mit genau zwei Feldern: dem Zielformat und der Datei selbst. Die Reihenfolge der Felder spielt keine Rolle.
curl -X POST https://rework.live/api/v1/convert \
-H "Authorization: Bearer rlv_your_key_here" \
-F "to=webp" \
-F "file=@photo.png"| Feld | Typ | Beschreibung |
|---|---|---|
| to | string | ID des Zielformats, zum Beispiel pdf, webp, mp4 |
| file | file | Die umzuwandelnde Datei. Eine pro Anfrage. |
Die Antwort
Immer JSON, nie reine Bytes, und immer dieselbe Struktur — ob die Umwandlung fertig ist oder eingereiht wurde. Ein Client, der am Content-Type ablesen müsste, was er bekommen hat, ist ein Client, der es irgendwann falsch macht.
200 bedeutet: Der Auftrag ist fertig und download steht bereit. 202 bedeutet: Er wurde eingereiht — status_url ist die Abfrageadresse, und download ist bis zur Fertigstellung null.
{
"job": {
"id": "6a84860000000000000000ab",
"status": "done",
"from": "png",
"to": "webp",
"bytes": 48213,
"durationMs": 412,
"notes": [],
"expiresAt": "2026-09-03T10:22:31.000Z",
"download": "https://rework.live/api/v1/jobs/6a84860000000000000000ab/download",
"status_url": null,
"queuePosition": null,
"estimateMs": null
}
}Die Bytes direkt beziehen
Hängen Sie ?download=1 an, wenn Sie lieber die Datei als einen Link möchten. Eine sofort abgeschlossene Umwandlung liefert dann die Bytes; eine eingereihte antwortet weiterhin mit 202 und JSON, weil es noch nichts zu senden gibt.