Consultar e descarregar
Uma conversão em fila entrega-lhe um identificador de trabalho. Estes dois endpoints dizem-lhe quando está pronto e dão-lhe o ficheiro.
Verificar o estado
GET https://rework.live/api/v1/jobs/:id, com o mesmo token bearer. Enquanto o trabalho espera, recebe também a sua posição na fila e uma estimativa, para que um cliente possa mostrar algo mais útil do que um indicador a rodar.
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| Estado | Significado |
|---|---|
| queued | À espera de um processo. queuePosition está preenchido. |
| running | A ser convertido agora. |
| done | Terminado. download está pronto. |
| failed | Não converteu. Nada foi contado à sua quota. |
Descarregar o resultado
GET https://rework.live/api/v1/jobs/:id/download devolve os bytes convertidos com o content type correto e um nome de ficheiro. Funciona até o trabalho expirar, o que é decidido pela janela de conservação do seu plano.
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"Os trabalhos pertencem às chaves
Um trabalho criado por uma conta não pode ser lido por outra. Pedir o trabalho de outra pessoa devolve 404, não 403, e isso é deliberado: um identificador de trabalho é suficientemente adivinhável para que distinguir «não é seu» de «não existe» revelasse que as conversões de outras pessoas existem.
Consulte com um intervalo sensato — a estimativa na resposta está lá para lhe dar o ritmo. Consultar num ciclo apertado conta para o seu limite horário como qualquer outra coisa.