Asset-Bibliothek
Jedes Projekt hat eine Medienbibliothek. Eine Datei wird einmal hochgeladen und erhält eine stabile ID, und das Bild-, Video- oder Datei-Feld jedes Datensatzes verweist über diese ID auf sie.
So funktioniert ein Upload
Ein Upload hat drei Schritte. createFileUpload gibt eine Upload-URL zurück, die eine Stunde gültig ist, der Client sendet die Bytes direkt an den Speicher, und ein Bestätigungsaufruf gibt die Datei zurück. Die Bytes laufen nie über den GraphQL-Endpunkt. Dieser Weg hat kein Größenlimit pro Datei, und die Prüfung bei der Bestätigung erfolgt gegen Ihr Speicherkontingent. Ein REST-Upload in einem einzigen Aufruf nimmt kleine Dateien bis 10 MB.
Der Browser eines angemeldeten Nutzers kann den gesamten Upload mit einem öffentlichen Schlüssel und dem eigenen Token dieses Nutzers ausführen. Die Datei gehört dann ihm und ist standardmäßig privat.
Was aus einem Bild ausgelesen wird
Für JPEG, PNG, WebP und GIF extrahiert Fóir bei der Bestätigung des Uploads Breite, Höhe, einen Blurhash-Platzhalter und eine dominante Farbe. Ein Bildfeld gibt alle vier neben der URL zurück. Andere Größen und Formate kommen aus Bildtransformationen.
Ordner, Alt-Text und die CLI
Eine Datei kann in einem Ordner liegen und einen Alt-Text tragen, und die öffentliche API gibt beides mit der Datei zurück. Im Terminal lädt foir media Dateien hoch, listet, aktualisiert, löscht und stellt sie wieder her.
Löschen und Wiederherstellen
Ein Löschen ist weich, und eine Wiederherstellung macht es rückgängig. Das Entfernen des gespeicherten Objekts ist ein eigenes, endgültiges Löschen. Zum Löschen ist der Scope files:delete erforderlich, den Schreibzugriff auf Dateien nicht einschließt.
Was abgelehnt wird
HTML-, JavaScript- und XML-Uploads werden abgelehnt. SVG wird akzeptiert, und eine direkt geöffnete wird als Download ausgeliefert, unter einer Richtlinie, die Skripte blockiert.
Details nachlesen
Die Medien-Anleitung behandelt Uploads, Sichtbarkeit, die CLI-Befehle, Zuschnitte und Video.