stable · overview · 0.1.0

Files & Media

安全的 File Object lifecycle

Files & Media 讓 Project Backend 先宣告檔案雜湊、content type 與大小上限，再取得 single-use upload grant。新 File Object 一律進入 quarantine，只有安全分類完成後才可取得 opaque、短效 private download grant，或透過事先核准、會移除 metadata 的 image preset 發布 Public Asset。

先閱讀 File Object lifecycle，再依照上傳與 quarantine完成 sandbox 流程。

適合使用的時機

• 你需要讓 Project Backend 以短效 grant 上傳受控內容。
• 你需要在公開或下載前完成完整性與惡意內容檢查。
• 你需要以 files:read 建立短效 private download grant，或以 files:write 發布隔離的 Public Asset。

不適合使用的時機

Files & Media 不取代 Project Backend 對業務附件、保留期限與 Platform Account 授權的判斷。

Guides

• File Object lifecycle — 理解 File Object 從 upload grant、quarantined 到 available 或 rejected 的狀態。
• 上傳與 quarantine — 在 sandbox 建立 upload grant，並安全完成 quarantine 中的 File Object。

API Reference

• Create a File Object upload grant — POST /api/v1/file-objects/upload-grants
• Upload bytes with a single-use grant — PUT /api/v1/file-uploads/{uploadToken}
• Complete and classify a quarantined File Object — POST /api/v1/file-objects/{fileObjectId}/complete
• Create a short-lived authorized private download grant — POST /api/v1/file-objects/{fileObjectId}/download-grants
• Publish an available image through an approved metadata-stripping preset — POST /api/v1/file-objects/{fileObjectId}/public-assets