Der Formatkatalog

Ein öffentlicher, nicht authentifizierter Endpunkt liefert alles, was wir umwandeln, und jeden Weg zwischen den Formaten. Bauen Sie Ihre Oberfläche daraus, statt eine Liste fest zu verdrahten.

Kein Schlüssel nötig

GET https://rework.live/api/v1/formats benötigt keine Authentifizierung. Es ist eine Fähigkeitsliste und keine Nutzdaten, und einen Schlüssel zu verlangen, nur um zu erfahren, was ein Dienst umwandelt, ist eine kleine Unfreundlichkeit — es hieße auch, dass niemand die API vor dem Bezahlen prüfen könnte.

Die Antwort ist eine Stunde lang zwischenspeicherbar. Rufen Sie sie beim Start ab, nicht bei jeder Anfrage.

curl https://rework.live/api/v1/formats

Was zurückkommt

Zwei Listen. formats beschreibt jedes Format, das wir lesen oder schreiben können; conversions ist jede Kante dazwischen.

{
  "formats": [
    {
      "id": "png",
      "label": "PNG",
      "kind": "image",
      "extensions": ["png"],
      "mime": "image/png"
    }
  ],
  "conversions": [
    {
      "from": "png",
      "to": "webp",
      "fidelity": "high",
      "async": false,
      "maxInputMb": 200,
      "options": []
    }
  ]
}

Feld	Beschreibung
from / to	Format-IDs, die die Kante verbindet
fidelity	Wie originalgetreu die Umwandlung ist
async	Wahr, wenn diese Umwandlung eingereiht statt sofort ausgeführt wird
maxInputMb	Größte Eingabe, die genau diese Umwandlung annimmt
options	Zusätzliche Parameter dieser Umwandlung, falls vorhanden

Zwei Obergrenzen, nicht eine

maxInputMb ist die Grenze für genau diese Umwandlung. Ihr Tarif hat eine eigene, und es gilt die kleinere von beiden. Ein 400-MB-Video scheitert also auch mit einem Plus-Konto, wenn die Umwandlung selbst weniger annimmt.