Il catalogo dei formati

Un unico endpoint pubblico e non autenticato restituisce tutto ciò che convertiamo e ogni percorso tra i formati. Costruisci la tua interfaccia a partire da lì invece di fissare un elenco nel codice.

Nessuna chiave necessaria

GET https://rework.live/api/v1/formats non richiede autenticazione. È un elenco di capacità, non dati, e chiedere una chiave per sapere cosa converte un servizio è una piccola ostilità; significherebbe anche che nessuno può valutare l’API prima di pagarla.

La risposta è memorizzabile in cache per un’ora. Richiedila all’avvio, non a ogni richiesta.

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

Cosa torna

Due elenchi. formats descrive ogni formato che sappiamo leggere o scrivere; conversions è ogni arco tra essi.

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

Campo	Descrizione
from / to	Identificativi dei formati collegati dall’arco
fidelity	Quanto è fedele la conversione
async	Vero quando questa conversione va in coda invece di essere immediata
maxInputMb	Input più grande accettato da questa specifica conversione
options	Parametri aggiuntivi accettati da questa conversione, se presenti

Due tetti, non uno

maxInputMb è il tetto di quella specifica conversione. Il tuo piano ha il suo, e vale il più basso dei due. Un video da 400 MB su un account Plus fallisce comunque se la conversione stessa accetta meno.