Bibliothèque de ressources
Chaque projet a une bibliothèque de médias. Un fichier est téléversé une fois et reçoit un id stable, et le champ image, vidéo ou fichier de n'importe quel enregistrement y renvoie par cet id.
Comment fonctionne un téléversement
Un téléversement comporte trois étapes. createFileUpload renvoie une URL de téléversement valable une heure, le client envoie les octets directement au stockage, et un appel de confirmation renvoie le fichier. Les octets ne passent jamais par le point d'accès GraphQL. Cette voie n'a pas de limite de taille par fichier, et la vérification à la confirmation porte sur votre quota de stockage. Un téléversement REST en un seul appel accepte les petits fichiers, jusqu'à 10 Mo.
Le navigateur d'un utilisateur connecté peut mener tout le téléversement avec une clé publique et le jeton de cet utilisateur. Le fichier est alors le sien, et privé par défaut.
Ce qui est lu dans une image
Pour JPEG, PNG, WebP et GIF, Fóir extrait la largeur, la hauteur, un placeholder blurhash et une couleur dominante à la confirmation du téléversement. Un champ image renvoie les quatre à côté de l'URL. Les autres tailles et formats viennent des transformations d'image.
Dossiers, texte alternatif et CLI
Un fichier peut se trouver dans un dossier et porter un texte alternatif, et l'API publique renvoie les deux avec le fichier. Depuis un terminal, foir media téléverse, liste, met à jour, supprime et restaure des fichiers.
Supprimer et restaurer
Une suppression est logique, et une restauration l'annule. Retirer l'objet stocké est une suppression distincte et définitive. Supprimer exige la portée files:delete ; l'accès en écriture aux fichiers ne l'implique pas.
Ce qui est refusé
Les téléversements HTML, JavaScript et XML sont refusés. Le SVG est accepté, et un SVG ouvert directement est servi en téléchargement sous une politique qui bloque les scripts.
Lire le détail
Le guide des médias couvre les téléversements, la visibilité, les commandes CLI, les recadrages et la vidéo.