Le catalogue des formats

Un point d’accès public et sans authentification renvoie tout ce que nous convertissons et tous les chemins entre formats. Construisez votre interface à partir de lui plutôt que de figer une liste dans le code.

Aucune clé requise

GET https://rework.live/api/v1/formats ne demande aucune authentification. C’est une liste de capacités et non des données, et exiger une clé pour savoir ce qu’un service convertit est une petite hostilité — cela signifierait aussi que personne ne peut évaluer l’API avant de payer.

La réponse est cachable une heure. Récupérez-la au démarrage, pas à chaque requête.

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

Ce que vous recevez

Deux tableaux. formats décrit chaque format que nous savons lire ou écrire ; conversions est chaque arête entre eux.

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

Champ	Description
from / to	Identifiants de formats reliés par l’arête
fidelity	Fidélité de la conversion
async	Vrai lorsque cette conversion passe en file au lieu de s’exécuter à la volée
maxInputMb	Plus grande entrée acceptée par cette conversion précise
options	Paramètres supplémentaires acceptés par cette conversion, le cas échéant

Deux plafonds, pas un

maxInputMb est le plafond de cette conversion précise. Votre offre a le sien, et c’est le plus bas des deux qui s’applique. Une vidéo de 400 Mo sur un compte Plus échoue quand même si la conversion elle-même accepte moins.