Come funziona
Una conversione è fatta di quattro passaggi: capiamo che cos’è davvero il file, troviamo un percorso verso il formato richiesto, lo eseguiamo e ti consegniamo il risultato. Eccoli uno per uno.
Riconosciamo il formato dai byte, non dal nome
Un file chiamato report.pdf non è per forza un PDF, e un file senza alcuna estensione di solito resta identificabile. La prima cosa che facciamo è quindi leggere i primi byte del caricamento e confrontarli con firme di formato note.
Conta più di quanto sembri. Fidarsi dell’estensione significa che un file rinominato fallisce con un errore incomprensibile o, peggio, finisce nello strumento sbagliato. Leggere i byte significa che un file etichettato male si converte comunque correttamente e che uno che davvero non è ciò che dichiara viene rifiutato con chiarezza.
Le conversioni sono un grafo, non un elenco
Ogni conversione supportata è un arco tra due formati, e ogni arco registra quanto è fedele, quanto costa all’incirca e la dimensione massima di input che accetta. Da quel grafo sono generate le pagine dei formati, ed è pubblicato per intero tramite l’API.
Se tra i due formati indicati non esiste alcun arco, te lo diciamo subito e non dopo un caricamento. Nulla viene instradato di nascosto attraverso un formato intermedio con perdita per far sembrare che una conversione funzioni.
Le conversioni veloci sono immediate, quelle lente vanno in coda
Ridimensionare un’immagine richiede molto meno di un secondo, quindi avviene dentro la richiesta stessa e la risposta contiene già il risultato. Rendere un documento lungo o transcodificare un video no: quei lavori vengono messi in coda e presi in carico da un gruppo separato di processi.
Non devi mai indovinare cosa hai ottenuto. Un lavoro finito torna con il risultato; uno in coda torna con un identificativo, una posizione in coda e una stima, e lo interroghi oppure aspetti l’e-mail.
Nel piano Plus il lavoro in coda passa davanti a quello dei piani gratuiti: è questo che significa in pratica la priorità di quel piano.
Nulla viene convertito due volte da due percorsi diversi
Il sito, l’API e la conversione via e-mail sono tre porte su un’unica pipeline. Differiscono solo per come viene identificato il chiamante — un cookie di sessione, un token bearer o il mittente di un’e-mail — e poi eseguono esattamente lo stesso codice.
È un vincolo deliberato, non un dettaglio implementativo. Due implementazioni di «controlla la quota, annusa i byte, proteggi l’archivio» sono il modo in cui una delle due finisce per saltare un passaggio proprio per chi ha meno probabilità di accorgersene.