Katalog formatów

Jeden publiczny punkt końcowy bez uwierzytelniania zwraca wszystko, co konwertujemy, i każdą trasę między formatami. Buduj swój interfejs na jego podstawie zamiast wpisywać listę na sztywno.

Klucz nie jest potrzebny

GET https://rework.live/api/v1/formats nie wymaga uwierzytelniania. To lista możliwości, a nie dane, a żądanie klucza tylko po to, by dowiedzieć się, co usługa konwertuje, jest drobną nieuprzejmością — oznaczałoby też, że nikt nie może ocenić API przed zapłaceniem.

Odpowiedź można cache’ować przez godzinę. Pobierz ją przy starcie, a nie przy każdym żądaniu.

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

Co wraca

Dwie listy. formats opisuje każdy format, który umiemy odczytać lub zapisać; conversions to każda krawędź między nimi.

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

Pole	Opis
from / to	Identyfikatory formatów łączonych przez krawędź
fidelity	Jak wierna jest konwersja
async	Prawda, gdy ta konwersja trafia do kolejki zamiast działać od ręki
maxInputMb	Największe wejście przyjmowane przez tę konkretną konwersję
options	Dodatkowe parametry przyjmowane przez tę konwersję, jeśli istnieją

Dwa pułapy, nie jeden

maxInputMb to pułap tej konkretnej konwersji. Twój plan ma własny i obowiązuje niższy z dwóch. Wideo o rozmiarze 400 MB na koncie Plus i tak się nie powiedzie, jeśli sama konwersja przyjmuje mniej.