Опрос и скачивание
Поставленная в очередь конвертация выдаёт идентификатор задачи. Эти два эндпоинта сообщают, когда она готова, и отдают файл.
Проверка состояния
GET https://rework.live/api/v1/jobs/:id, с тем же bearer-токеном. Пока задача ждёт, вы также получаете её позицию в очереди и оценку, чтобы клиент мог показать что-то полезнее крутящегося индикатора.
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| Состояние | Значение |
|---|---|
| queued | Ожидает обработчика. queuePosition заполнено. |
| running | Конвертируется прямо сейчас. |
| done | Завершено. download доступен. |
| failed | Не сконвертировано. Из вашей квоты ничего не списано. |
Скачивание результата
GET https://rework.live/api/v1/jobs/:id/download возвращает сконвертированные байты с правильным типом содержимого и именем файла. Работает до истечения срока задачи, который определяется окном хранения вашего тарифа.
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"Задачи принадлежат ключам
Задачу, созданную одним аккаунтом, не прочитает другой. Запрос чужой задачи возвращает 404, а не 403, и это сделано намеренно: идентификатор задачи достаточно угадываем, чтобы различие между «не ваша» и «не существует» выдало факт существования чужих конвертаций.
Опрашивайте с разумным интервалом — оценка в ответе для того и нужна, чтобы задать темп. Опрос в плотном цикле расходует часовой лимит так же, как любой другой запрос.