開始使用
合作夥伴的系統還不能標記事件時,用原始數據送一個檔案,或其他樣本。週期性的即時樣本請送到狀態。YAS 稍後會從這些紀錄標記事件。
- 簽發機械人媒體上傳(beta) —
POST /v1/robots/raw/media。先簽發網址,PUT 位元組,然後完成。再送會多存一個檔案。 - 送出機械人樣本(beta) —
POST /v1/robots/raw/samples。其他有名稱的樣本,1 至 100 筆。
上傳與 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 路徑與識別碼。
