Convertire un file
Un solo endpoint fa il lavoro. Invia un file e un formato di destinazione e ricevi un lavoro: completato se è stato veloce, in coda se non lo è stato.
Autenticazione
Tutti gli endpoint tranne il catalogo dei formati richiedono una chiave API, inviata come token bearer. Creane una nella pagina Automatizza del tuo account; viene mostrata una sola volta e conservata solo come hash, quindi una chiave persa non è recuperabile: emettine una nuova.
L’accesso all’API fa parte del piano Plus. Una chiave di un account che non lo ha viene rifiutata con NOT_ENTITLED.
Authorization: Bearer rlv_your_key_hereLa richiesta
POST https://rework.live/api/v1/convert, come multipart/form-data, con esattamente due campi: il formato di destinazione e il file stesso. L’ordine dei campi non conta.
curl -X POST https://rework.live/api/v1/convert \
-H "Authorization: Bearer rlv_your_key_here" \
-F "to=webp" \
-F "file=@photo.png"| Campo | Tipo | Descrizione |
|---|---|---|
| to | string | Identificativo del formato di destinazione, per esempio pdf, webp, mp4 |
| file | file | Il file da convertire. Uno per richiesta. |
La risposta
Sempre JSON, mai byte grezzi, e sempre con la stessa forma sia che la conversione sia finita sia che sia stata messa in coda. Un client costretto a guardare il content type per sapere cosa ha ricevuto è un client che prima o poi sbaglierà.
200 significa che il lavoro è finito e download è pronto. 202 significa che è stato messo in coda: status_url è dove interrogare e download è null finché non termina.
{
"job": {
"id": "6a84860000000000000000ab",
"status": "done",
"from": "png",
"to": "webp",
"bytes": 48213,
"durationMs": 412,
"notes": [],
"expiresAt": "2026-09-03T10:22:31.000Z",
"download": "https://rework.live/api/v1/jobs/6a84860000000000000000ab/download",
"status_url": null,
"queuePosition": null,
"estimateMs": null
}
}Ottenere direttamente i byte
Aggiungi ?download=1 se preferisci il file a un link. Una conversione che finisce immediatamente restituisce allora i byte; una che finisce in coda restituisce comunque 202 con JSON, perché non c’è ancora nulla da inviare.