Libreria degli asset
Ogni progetto ha una libreria multimediale. Un file viene caricato una sola volta e ottiene un id stabile, e il campo immagine, video o file di qualsiasi record vi fa riferimento tramite quell'id.
Come funziona un upload
Un upload ha tre passaggi. createFileUpload restituisce un URL di upload valido per un'ora, il client invia i byte direttamente allo storage e una chiamata di conferma restituisce il file. I byte non passano mai dall'endpoint GraphQL. Questo percorso non ha un limite di dimensione per file, e il controllo alla conferma avviene rispetto al tuo spazio di storage disponibile. Un upload REST in una sola chiamata accetta file piccoli, fino a 10 MB.
Il browser di un utente autenticato può eseguire l'intero upload con una chiave pubblica e il token di quell'utente. Il file è allora suo, e privato per default.
Cosa viene letto da un'immagine
Per JPEG, PNG, WebP e GIF, Fóir estrae larghezza, altezza, un segnaposto blurhash e un colore dominante quando l'upload viene confermato. Un campo immagine restituisce tutti e quattro accanto all'URL. Altre dimensioni e formati arrivano dalle trasformazioni delle immagini.
Cartelle, testo alternativo e CLI
Un file può stare in una cartella e avere un testo alternativo, e l'API pubblica restituisce entrambi con il file. Da terminale, foir media carica, elenca, aggiorna, elimina e ripristina i file.
Eliminare e ripristinare
Un'eliminazione è logica, e un ripristino la annulla. Rimuovere l'oggetto salvato è un'eliminazione separata e permanente. Eliminare richiede files:delete come scope, che l'accesso in scrittura ai file non implica.
Cosa viene rifiutato
Gli upload di HTML, JavaScript e XML vengono rifiutati. L'SVG è accettato, e uno aperto direttamente viene servito come download con una policy che blocca gli script.
Leggi il dettaglio
La guida ai media copre upload, visibilità, comandi della CLI, ritagli e video.