Odpytywanie i pobieranie
Zakolejkowana konwersja daje Ci identyfikator zadania. Te dwa punkty końcowe mówią, kiedy jest gotowe, i wydają plik.
Sprawdzanie stanu
GET https://rework.live/api/v1/jobs/:id, z tym samym tokenem bearer. Dopóki zadanie czeka, dostajesz też jego pozycję w kolejce i szacunek, dzięki czemu klient może pokazać coś użyteczniejszego niż kręcące się kółko.
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| Stan | Znaczenie |
|---|---|
| queued | Czeka na proces roboczy. queuePosition jest ustawione. |
| running | Właśnie jest konwertowane. |
| done | Zakończone. download jest gotowy. |
| failed | Nie przekonwertowano. Nic nie odjęto od Twojego limitu. |
Pobranie wyniku
GET https://rework.live/api/v1/jobs/:id/download zwraca przekonwertowane bajty z właściwym typem zawartości i nazwą pliku. Działa do wygaśnięcia zadania, o czym decyduje okno przechowywania w Twoim planie.
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"Zadania należą do kluczy
Zadania utworzonego przez jedno konto nie odczyta inne. Zapytanie o cudze zadanie zwraca 404, a nie 403, i jest to celowe: identyfikator zadania jest na tyle odgadywalny, że odróżnienie „nie Twoje” od „nie istnieje” zdradzałoby, że konwersje innych osób istnieją.
Odpytuj w rozsądnych odstępach — szacunek w odpowiedzi służy właśnie do wyznaczenia tempa. Odpytywanie w ciasnej pętli liczy się do limitu godzinowego jak każde inne żądanie.