Abfragen und Herunterladen
Eine eingereihte Umwandlung gibt Ihnen eine Auftrags-ID. Diese beiden Endpunkte sagen Ihnen, wann sie fertig ist, und liefern die Datei.
Status abfragen
GET https://rework.live/api/v1/jobs/:id, mit demselben Bearer-Token. Solange der Auftrag wartet, erhalten Sie zusätzlich seine Position in der Warteschlange und eine Schätzung, sodass ein Client mehr anzeigen kann als einen Ladekreis.
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| Status | Bedeutung |
|---|---|
| queued | Wartet auf einen Worker. queuePosition ist gesetzt. |
| running | Wird gerade umgewandelt. |
| done | Fertig. download steht bereit. |
| failed | Nicht umgewandelt. Es wurde nichts auf Ihr Kontingent angerechnet. |
Das Ergebnis herunterladen
GET https://rework.live/api/v1/jobs/:id/download liefert die umgewandelten Bytes mit passendem Content-Type und Dateinamen. Der Abruf funktioniert, bis der Auftrag abläuft — bestimmt durch die Aufbewahrungsfrist Ihres Tarifs.
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"Aufträge gehören zu Schlüsseln
Ein Auftrag eines Kontos kann von keinem anderen gelesen werden. Die Abfrage eines fremden Auftrags liefert 404 und nicht 403 — und das mit Absicht: Eine Auftrags-ID ist erratbar genug, dass die Unterscheidung zwischen „nicht Ihrer“ und „existiert nicht“ verraten würde, dass es die Umwandlungen anderer Leute gibt.
Fragen Sie in sinnvollen Abständen ab — die Schätzung in der Antwort gibt den Takt vor. Abfragen in einer engen Schleife zählt wie jede andere Anfrage gegen Ihre Stundenrate.