アセットライブラリ

アップロードの流れ

アップロードは3つのステップです。createFileUploadが1時間有効なアップロードURLを返し、クライアントがバイトを直接ストレージに送り、確認の呼び出しがファイルを返します。バイトがGraphQLエンドポイントを通ることはありません。この経路にはファイルごとのサイズ制限はなく、確認時にはストレージの割り当てに対してチェックされます。1回の呼び出しで行うRESTアップロードは、10 MBまでの小さなファイルに対応します。

サインイン済みユーザーのブラウザーは、公開キーとそのユーザー自身のトークンで、アップロード全体を実行できます。その場合、ファイルはそのユーザーのものになり、既定で非公開です。

画像から読み取られる情報

JPEG、PNG、WebP、GIFについては、アップロードが確認された時点で、Fóirが幅、高さ、blurhashのプレースホルダー、代表色を抽出します。画像フィールドは、URLとともにこの4つをすべて返します。ほかのサイズや形式は画像変換で取得します。

フォルダー、代替テキスト、CLI

ファイルはフォルダーに置いたり代替テキストを付けたりでき、公開APIはファイルとともにその両方を返します。ターミナルからは、foir mediaでファイルのアップロード、一覧表示、更新、削除、復元ができます。

削除と復元

削除は論理削除で、復元すると元に戻ります。保存されているオブジェクトの削除は別の操作で、完全に削除されます。削除にはfiles:deleteスコープが必要で、ファイルへの書き込みアクセスがあっても、このスコープは付与されません。

拒否されるもの

HTML、JavaScript、XMLのアップロードは拒否されます。SVGは受け付けられ、直接開かれた場合は、スクリプトをブロックするポリシーのもとでダウンロードとして提供されます。