跳到內容

開始使用

合作夥伴的系統還不能標記事件時,用原始數據送一個檔案,或其他樣本。週期性的即時樣本請送到狀態。YAS 稍後會從這些紀錄標記事件。

上傳與 complete

小節:上傳與 complete

目前每檔最多 50 MiB,或較低的 Storage 設定上限。Signed upload 憑證有效兩小時,須於簽發後 24 小時內 complete。PUT 請使用宣告的媒體 Content-Type。Mint 與 complete 請指定 API 執行區域;Storage PUT 不需要 region header。Server key 只留在後端,不要送到 upload URL,也不要分享 signed URL 或把它寫入 log。

後端可參考英文版的 curl 範例,依序呼叫 mint、PUT、complete。範例需要 curl、jq、已註冊的機械人及 JPEG 檔案;從安全環境提供憑證,並關閉 shell tracing。

只有 complete 成功才會成為 ready。若遺失 complete 回應,可以相同 mediaId 重試。409 upload_incomplete 表示尚未有完整物件。422 invalid_media 表示大小或類型不符;物件不可覆寫,請重新簽發上傳。410 upload_expired 表示 complete 期限已過。每次 mint 都會建立新的檔案 id,因此回應不確定時,請先重試 complete。

媒體上傳必須使用 byteLength 與 signed upload → complete 流程。含有 contentBase64 的請求會回傳 400 invalid_body,不支援 inline 媒體上傳。較早的 /v1/robots/raw/media/uploads 與 /v1/robots/raw/media/uploads/{uploadId}/complete 流程也維持相容,包括 sizeBytes、idempotencyKey 及 resumable upload 回應。請使用該流程對應的 complete 路徑與識別碼。