Consultar y descargar
Una conversión encolada te entrega un identificador de trabajo. Estos dos endpoints te dicen cuándo está listo y te dan el archivo.
Consultar el estado
GET https://rework.live/api/v1/jobs/:id, con el mismo token bearer. Mientras el trabajo espera también obtienes su posición en la cola y una estimación, para que un cliente pueda mostrar algo más útil que un indicador de carga.
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| Estado | Significado |
|---|---|
| queued | Esperando a un proceso. queuePosition está definido. |
| running | Convirtiéndose ahora mismo. |
| done | Terminado. download está listo. |
| failed | No se convirtió. No se descontó nada de tu cuota. |
Descargar el resultado
GET https://rework.live/api/v1/jobs/:id/download devuelve los bytes convertidos con el tipo de contenido correcto y un nombre de archivo. Funciona hasta que el trabajo caduca, lo que decide la ventana de conservación de tu plan.
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"Los trabajos pertenecen a las claves
Un trabajo creado por una cuenta no puede leerlo otra. Pedir el trabajo de otra persona devuelve 404, no 403, y es deliberado: un identificador de trabajo es lo bastante adivinable como para que distinguir «no es tuyo» de «no existe» revelase que existen las conversiones de otras personas.
Consulta a un intervalo razonable: la estimación de la respuesta está ahí para marcarte el ritmo. Sondear en un bucle cerrado cuenta para tu límite por hora como cualquier otra cosa.