Come funzionano i caricamenti locali e remoti
Questa guida illustra nel dettaglio l’intero flusso per caricare file utilizzando l’API Frame.io V4. Copre richieste e risposte API non elaborate per i caricamenti locali e remoti.
Cerchi guide specifiche per gli SDK? Per implementare caricamenti con funzioni integrate di suddivisione in chunk, nuovi tentativi e tracciamento dello stato di avanzamento, consulta la guida al caricamento dell’SDK Python.
Prerequisiti
Prima di iniziare a caricare i file, assicurati di aver completato questi passaggi di configurazione:
Account Frame.io V4
Hai un account Frame.io V4 amministrato tramite Adobe Admin Console, OPPURE sei passato all’autenticazione Adobe per l’utente dell’account
Configurazione di Adobe Developer Console
Hai effettuato l’accesso ad Adobe Developer Console e hai aggiunto l’API Frame.io a un progetto nuovo o esistente
Credenziali di autenticazione
Hai generato le credenziali di autenticazione appropriate per il tuo progetto
Scelta del metodo di caricamento
Esistono due modi per caricare un file utilizzando l’API Frame.io: Create File (local upload) e Create File (remote upload).
Da utilizzare quando i media sono accessibili localmente alla tua applicazione; è simile al trascinamento di un file dal desktop
Da utilizzare quando i media sono accessibili tramite rete, ad esempio attraverso un’integrazione con un altro servizio
In questa guida inizieremo con il caso più semplice del completamento di un caricamento remoto.
Caricamento remoto
Per creare un file tramite caricamento remoto, seleziona l’endpointCreate File (remote upload). Il corpo della richiesta richiede il nome del file e il suo URL di origine.
Il caricamento remoto ha attualmente un limite di dimensione del file di 50 GB. Per file più grandi di 50 GB, utilizza il caricamento locale.
Esempio di richiesta
Esempio di risposta
Una richiesta riuscita restituirà una risposta come quella di seguito:
Caricamento locale
Per creare un file tramite caricamento locale, seleziona l’endpointCreate File (local upload). Il corpo della richiesta richiede il nome del file e la sua dimensione specificata in byte.
Esempio di richiesta
Esempio di risposta
Se la richiesta riesce, viene creata una risorsa di file segnaposto senza contenuto. In base alla dimensione del file, il corpo della risposta includerà uno o più upload_url. In base a questo esempio, dovremo gestire il caricamento in più parti.
Requisiti di caricamento importanti:
Questi sono alcuni dettagli importanti da tenere presenti quando invii le successive richieste di caricamento:
- Il metodo di richiesta HTTP deve essere
PUT - L’intestazione
x-amz-acldeve essere inclusa e impostata su private - L’intestazione
Content-Typedeve corrispondere almedia_typespecificato nella richiesta Create File (local upload) originale. Questo vale anche durante il caricamento del file come parti separate. Nell’esempio precedente, il valore permedia_typeèimage/jpeg. Pertanto, anche il valore perContent-Typedeve essereimage/jpeg.
Caricamento multi-parte
Quando un determinato file restituisce più di un URL di caricamento, occorre dividere il file di origine in chunk e inviare una richiesta PUT per ciascuno.
Consigliato: la guida al caricamento dell’SDK Python tratta il caricamento multi-parte usando FrameioUploader, che gestisce automaticamente la suddivisione in chunk, i caricamenti paralleli, i nuovi tentativi e il tracciamento dello stato di avanzamento.
Se devi implementare il caricamento manualmente, ad esempio in un linguaggio senza SDK o per il controllo completo del processo, lo script in basso mostra come dividere un file in chunk e come caricare ciascuno usando gli URL pre-firmati.
Esempio di implementazione Python
Riepilogo del flusso caricamento
Scegli il metodo di caricamento
Decidi tra caricamento remoto (file accessibile tramite URL) o caricamento locale (file sul sistema)
Crea una richiesta di file
Effettua la richiesta iniziale per creare la risorsa di file con i metadati necessari
Gestisci l'URL di caricamento
Per i caricamenti locali, elabora gli upload_url restituiti (singola parte o multi-parte)
Passaggi successivi: una volta caricato il file, puoi usare l’ID file restituito per aggiungere commenti, creare condivisioni o eseguire altre operazioni usando l’API Frame.io V4.