El catálogo de formatos
Un único endpoint público y sin autenticación devuelve todo lo que convertimos y todas las rutas entre formatos. Construye tu interfaz a partir de él en vez de fijar una lista en el código.
No hace falta clave
GET https://rework.live/api/v1/formats no necesita autenticación. Es una lista de capacidades, no datos, y exigir una clave para saber qué convierte un servicio es una pequeña hostilidad; además significaría que nadie puede evaluar la API antes de pagarla.
La respuesta se puede cachear una hora. Pídela al arrancar, no en cada petición.
curl https://rework.live/api/v1/formatsQué se recibe
Dos listas. formats describe cada formato que sabemos leer o escribir; conversions es cada arista entre ellos.
{
"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 | Descripción |
|---|---|
| from / to | Identificadores de formato que une la arista |
| fidelity | Cuán fiel es la conversión |
| async | Verdadero cuando esta conversión se encola en lugar de ejecutarse al vuelo |
| maxInputMb | Mayor entrada que acepta esta conversión concreta |
| options | Parámetros adicionales que acepta esta conversión, si los hay |
Dos topes, no uno
maxInputMb es el tope de esa conversión concreta. Tu plan tiene el suyo, y se aplica el menor de los dos. Un vídeo de 400 MB en una cuenta Plus falla igualmente si la conversión en sí admite menos.