跳到內容

完成機械人媒體(beta)

Beta
POST
/v1/robots/raw/media/{mediaId}/complete
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。物件不能覆寫,內容不符時請重新簽發。

mediaId
required
string

簽發時交回的 id。

Example

62bc5e66-8e11-4940-a70d-22efc1979674

Request Bodyrequired

小節:Request Bodyrequired
Media 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"
}

檔案已生效。status 是 ready。檔案已是 ready 時再呼叫,仍是 200,status 是 ready。

Media typeapplication/json
object
mediaId
required
string
status
required

ready 表示檔案已生效。

string
Allowed values: ready

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"
}