Interrogare e scaricare
Una conversione in coda ti consegna un identificativo di lavoro. Questi due endpoint ti dicono quando è pronto e ti danno il file.
Controllare lo stato
GET https://rework.live/api/v1/jobs/:id, con lo stesso token bearer. Mentre il lavoro attende ricevi anche la sua posizione in coda e una stima, così un client può mostrare qualcosa di più utile di un indicatore di caricamento.
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| Stato | Significato |
|---|---|
| queued | In attesa di un processo. queuePosition è valorizzato. |
| running | In conversione adesso. |
| done | Completato. download è pronto. |
| failed | Non convertito. Nulla è stato conteggiato sulla tua quota. |
Scaricare il risultato
GET https://rework.live/api/v1/jobs/:id/download restituisce i byte convertiti con il content type corretto e un nome file. Funziona finché il lavoro non scade, cosa decisa dalla finestra di conservazione del tuo piano.
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"I lavori appartengono alle chiavi
Un lavoro creato da un account non può essere letto da un altro. Chiedere il lavoro di qualcun altro restituisce 404, non 403, ed è deliberato: un identificativo di lavoro è abbastanza indovinabile che distinguere «non è tuo» da «non esiste» rivelerebbe che le conversioni di altre persone esistono.
Interroga a intervalli sensati: la stima nella risposta serve proprio a darti il ritmo. Interrogare in un ciclo stretto conta sul tuo limite orario come qualsiasi altra richiesta.