結束行程(已棄用)
Deprecated
Beta
POST
/v1/trips/end
const url = 'https://api.example.yas/v1/trips/end';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"partnerId":"partner","endTime":"2026-10-15T10:45:00.000Z","sessionId":"0199e0a0-0000-7000-8000-000000000001"}'};
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/trips/end \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "partnerId": "partner", "endTime": "2026-10-15T10:45:00.000Z", "sessionId": "0199e0a0-0000-7000-8000-000000000001" }'已棄用。請改用 POST /v1/vehicles/trips/end。內容與錯誤相同。這次呼叫是 beta。
Authorizations
小節:AuthorizationsRequest Bodyrequired
小節:Request BodyrequiredMedia typeapplication/json
只送 sessionId 或 tripId 其中一個。兩個都送,或兩個都不送,是 400。endTime 必須是以 Z 結尾的 UTC。
object
partnerId
required
來自 setup 的合作夥伴 id。必須與 server key 相符。
string
endTime
required
以 Z 結尾的 UTC,例如 2026-10-15T10:45:00.000Z。+08:00 這類時區偏移是 400。
string format: date-time
sessionId
要結束的未結束 session。送這個或 tripId,不要兩個都送。
string format: uuid
tripId
要結束的合作夥伴行程 id。送這個或 sessionId,不要兩個都送。
string
Example
{ "partnerId": "partner", "endTime": "2026-10-15T10:45:00.000Z", "sessionId": "0199e0a0-0000-7000-8000-000000000001"}Responses
小節:Responses200
小節:200行程已結束。未知的 sessionId 會記成已結束。
Media typeapplication/json
object
endTime
required
已保存的時間。之後再呼叫不會改寫。
string format: date-time
endedBy
required
partner 表示後端結束,phone 表示 SDK 結束,silence 表示手機停止回報。之後再呼叫不會改寫。
string
sessionId
required
string format: uuid
tripId
string
Example
{ "endTime": "2026-10-15T10:45:00.000Z", "endedBy": "partner", "sessionId": "0199e0a0-0000-7000-8000-000000000001", "tripId": "booking_1001"}400`endTime` 必須是以 `Z` 結尾的 UTC,例如 `2026-10-15T10:45:00.000Z`。帶時區偏移、缺少或不是真實時間、`sessionId` 不是 UUID、`tripId` 是空字串、兩個 id 都有,或兩個都沒有,都是 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未知的 `tripId`。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "not_found"}409這個 `tripId` 有多於一個未結束的 session。
Media typeapplication/json
object
error
required
穩定的錯誤代碼。沒有 stack trace。
string
Example
{ "error": "ambiguous_trip"}