完成機械人媒體(beta)
Beta
POST
/v1/robots/raw/media/{mediaId}/complete
const url = 'https://api.example.yas/v1/robots/raw/media/62bc5e66-8e11-4940-a70d-22efc1979674/complete';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"partnerId":"partner","schemaVersion":"2026-11","sourceSystem":"partner-export"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.example.yas/v1/robots/raw/media/62bc5e66-8e11-4940-a70d-22efc1979674/complete \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "partnerId": "partner", "schemaVersion": "2026-11", "sourceSystem": "partner-export" }'Beta。完成後,檔案才會生效。請送 partnerId、schemaVersion 與 sourceSystem。mediaId 是簽發時交回的 id。請先把位元組 PUT 到簽發的網址。這個合作夥伴沒有這個 mediaId 是 404。第一次 complete 回傳 status ready。檔案已是 ready 時再呼叫,仍是 200,status 是 ready。 須於簽發後 24 小時內 complete。未收到上傳是 409 upload_incomplete;大小或類型不符是 422 invalid_media。上傳憑證可能先於 complete 期限失效;已上傳的有效物件仍可 complete。物件不能覆寫,內容不符時請重新簽發。
Authorizations
小節:AuthorizationsParameters
小節:ParametersPath Parameters
小節:Path ParametersmediaId
required
string
簽發時交回的 id。
Example
62bc5e66-8e11-4940-a70d-22efc1979674Request Bodyrequired
小節:Request BodyrequiredMedia typeapplication/json
object
partnerId
required
合作夥伴 id。必須與 server key 相符。
string
schemaVersion
required
這次內容的 schema 版本。例子:2026-11。
string
sourceSystem
required
送出這次內容的系統名稱。例子:partner-export。
string
Example
{ "partnerId": "partner", "schemaVersion": "2026-11", "sourceSystem": "partner-export"}Responses
小節:Responses200
小節:200檔案已生效。status 是 ready。檔案已是 ready 時再呼叫,仍是 200,status 是 ready。
Media typeapplication/json
object
mediaId
required
string
status
required
ready 表示檔案已生效。
string
Example
{ "mediaId": "62bc5e66-8e11-4940-a70d-22efc1979674", "status": "ready"}400缺少必填欄位。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "invalid_body"}401沒有 server key,或 server key 不正確。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "invalid_credentials"}403server key 可以只限車輛、只限機械人,或兩者都可以。超出範圍的呼叫是 403 `forbidden`,而且不會保存。`identity_mismatch` 表示 `partnerId` 與 server key 不符。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "forbidden"}404未知的 `mediaId`。什麼都不會存。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "not_found"}409尚未有完整物件。請在憑證失效前上傳,然後重試 complete。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "upload_incomplete"}41024 小時 complete 期限已過。請重新簽發;之前 ready 的地圖維持不變。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "upload_expired"}422上傳物件與宣告的大小或類型不符。請重新簽發並上傳正確內容;物件不能覆寫。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "invalid_media"}503Storage 或必要設定暫時無法使用。請按 Retry-After 指定時間重試。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "unavailable"}