Interroger et télécharger
Une conversion mise en file vous remet un identifiant de tâche. Ces deux points d’accès vous disent quand elle est prête et vous donnent le fichier.
Vérifier l’état
GET https://rework.live/api/v1/jobs/:id, avec le même jeton bearer. Tant que la tâche attend, vous obtenez aussi sa position dans la file et une estimation, de sorte qu’un client puisse afficher mieux qu’un indicateur de chargement.
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| État | Signification |
|---|---|
| queued | En attente d’un processus. queuePosition est renseigné. |
| running | En cours de conversion. |
| done | Terminé. download est prêt. |
| failed | Non convertie. Rien n’a été décompté de votre quota. |
Télécharger le résultat
GET https://rework.live/api/v1/jobs/:id/download renvoie les octets convertis avec le bon type de contenu et un nom de fichier. Cela fonctionne jusqu’à l’expiration de la tâche, déterminée par la fenêtre de conservation de votre offre.
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"Les tâches appartiennent aux clés
Une tâche créée par un compte ne peut être lue par un autre. Demander la tâche de quelqu’un d’autre renvoie 404, pas 403, et c’est délibéré : un identifiant de tâche est suffisamment devinable pour que distinguer « pas la vôtre » de « n’existe pas » révélerait que les conversions d’autres personnes existent.
Interrogez à un rythme raisonnable — l’estimation dans la réponse est là pour cela. Interroger en boucle serrée compte dans votre limite horaire comme n’importe quelle autre requête.