01 / DECIDE
架構決策
Document 或 media 需要被後續 API operation 引用時採用。
追蹤 owner、purpose、content type、processing state、retention、expiry、derived index 與 deletion。 先把 input、output、state、tool 與 side effect 畫成一條可觀察路徑,再決定 替 uploaded file 建立 lifecycle 的 owner。
02 / OPERATE
三步野戰程序
- 01
鎖定合約
寫下 caller、資料分類、成功條件、timeout、取消與 ownership。Document 或 media 需要被後續 API operation 引用時採用。
- 02
執行有界路徑
只建立一條 end-to-end path,保留 correlation、typed state 與 reversible failure。追蹤 owner、purpose、content type、processing state、retention、expiry、derived index 與 deletion。
- 03
驗證訊號
把驗收變成可重跑的 fixture、contract test 或 browser test。Lifecycle test 涵蓋 upload、processing、reject、expire、delete、unauthorized access 與 orphan cleanup。
03 / BOUND
Operation 邊界
驗證 type/size、避免公開暴露,並讓 deletion 傳遞到所有 dependent resource。
04 / PROVE
驗收證據
Lifecycle test 涵蓋 upload、processing、reject、expire、delete、unauthorized access 與 orphan cleanup。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://docs.x.ai/developers/advanced-api-usage/files' | sed -n '1,5p'