跳到內容

簽發 access token

POST
/v1/vehicles/tokens
curl --request POST \
--url https://api.example.yas/v1/vehicles/tokens \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "partnerId": "partner", "driverId": "drv_example", "vehicleId": "veh_example" }'

合作夥伴的後端用 server key 簽發 bearer。SDK 可使用該 bearer 24 小時。請按 setup 的 partnerId、driverId 與 vehicleId 簽發。POST /v1/tokens 已棄用。請用這條路徑。

Request Bodyrequired

小節:Request Bodyrequired
Media typeapplication/json
object
partnerId
required

來自 setup 的合作夥伴 id。必須與 server key 相符。

string
/^[a-z0-9-]{1,64}$/
driverId
required

來自 setup 的司機 id。

string
>= 1 characters
vehicleId
required

來自 setup 的車輛 id。

string
>= 1 characters

Example

{
"partnerId": "partner",
"driverId": "drv_example",
"vehicleId": "veh_example"
}

tokenProvider 要交回的 bearer。

Media typeapplication/json
object
accessToken
required
string
expiresAt
required

ISO-8601 UTC。Token 有效 24 小時。

string format: date-time
tokenType
required
string
Allowed values: Bearer

Example

{
"accessToken": "eyJexample",
"expiresAt": "2026-10-16T12:00:00.000Z",
"tokenType": "Bearer"
}
400內容不是 JSON object,`partnerId` 不符合 `^[a-z0-9-]{1,64}$`,或缺少 `driverId`、`vehicleId`,或它們是空字串。這項檢查在驗證身份之後、配對合作夥伴之前,所以格式不對的 `partnerId` 是 400,不是 403。
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"
}