送出機械人維修(beta)
const url = 'https://api.example.yas/v1/robots/maintenance';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"partnerId":"partner","schemaVersion":"2026-11","sourceSystem":"partner-export","robotId":"rbt_example","maintenanceId":"mnt_1001","timezone":"Asia/Hong_Kong","component":"drive","downtimeStart":"2026-10-15T12:00:00.000Z"}'};
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/maintenance \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "partnerId": "partner", "schemaVersion": "2026-11", "sourceSystem": "partner-export", "robotId": "rbt_example", "maintenanceId": "mnt_1001", "timezone": "Asia/Hong_Kong", "component": "drive", "downtimeStart": "2026-10-15T12:00:00.000Z" }'Beta。用 server key 建立或取代一筆維修紀錄。請送 partnerId、schemaVersion、sourceSystem、robotId、maintenanceId 與 timezone。這台機械人必須已存在於這個 partnerId。未知的 robotId 是 404。之後用同一個 partnerId、robotId 與 maintenanceId 再送,會蓋掉舊內容。選填欄位不送就會清掉。updatedAt 是 ISO-8601 UTC。
Authorizations
小節:AuthorizationsRequest Bodyrequired
小節:Request Bodyrequiredobject
合作夥伴 id。必須與 server key 相符。
這次內容的 schema 版本。例子:2026-11。
送出這次內容的系統名稱。例子:partner-export。
機械人 id。這台機械人必須已經存在。
這次維修的 id。同一合作夥伴、機械人與維修 id 再送,會蓋掉舊內容。
IANA 時區。例子:Asia/Hong_Kong。
這次維修相關的任務實例。沒有就可以不送。
這次維修相關的事件 id。沒有就可以不送。
報稱的問題。
查出的原因。
維修的部件。例子:drive。
更換的零件。
做了什麼。
停機開始的時間,ISO-8601。
停機結束的時間,ISO-8601。
這次維修的工時。
費用金額。請同時送 currency。
貨幣代碼。例子:HKD。
這個故障以前出現過時為 true。
這次維修在保養期內時為 true。
送出時的韌體版本。
合作夥伴的額外欄位。照送出的內容保存。
object
Example
{ "partnerId": "partner", "schemaVersion": "2026-11", "sourceSystem": "partner-export", "robotId": "rbt_example", "maintenanceId": "mnt_1001", "timezone": "Asia/Hong_Kong", "component": "drive", "downtimeStart": "2026-10-15T12:00:00.000Z"}Responses
小節:Responses200
小節:200維修已保存。之後用同一個維修 id 再送,會蓋掉它。updatedAt 是 ISO-8601 UTC。
object
Example
{ "robotId": "rbt_example", "maintenanceId": "mnt_1001", "updatedAt": "2026-10-15T13:00:00.000Z"}400缺少必填欄位。
object
穩定的錯誤代碼。沒有 stack trace。
Example
{ "error": "invalid_body"}401沒有 server key,或 server key 不正確。
object
穩定的錯誤代碼。沒有 stack trace。
Example
{ "error": "invalid_credentials"}403server key 可以只限車輛、只限機械人,或兩者都可以。超出範圍的呼叫是 403 `forbidden`,而且不會保存。`identity_mismatch` 表示 `partnerId` 與 server key 不符。
object
穩定的錯誤代碼。沒有 stack trace。
Example
{ "error": "forbidden"}404未知的 `robotId`。這次什麼都不會存。
object
穩定的錯誤代碼。沒有 stack trace。
Example
{ "error": "not_found"}