簽發 access token(已棄用)
Deprecated
POST
/v1/tokens
const url = 'https://api.example.yas/v1/tokens';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"partnerId":"partner","driverId":"drv_example","vehicleId":"veh_example"}'};
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/tokens \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "partnerId": "partner", "driverId": "drv_example", "vehicleId": "veh_example" }'已棄用。請改用 POST /v1/vehicles/tokens。內容與錯誤相同。
Authorizations
小節:AuthorizationsRequest Bodyrequired
小節:Request BodyrequiredMedia typeapplication/json
object
partnerId
required
來自 setup 的合作夥伴 id。必須與 server key 相符。
string
driverId
required
來自 setup 的司機 id。
string
vehicleId
required
來自 setup 的車輛 id。
string
Example
{ "partnerId": "partner", "driverId": "drv_example", "vehicleId": "veh_example"}Responses
小節:Responses200
小節:200tokenProvider 要交回的 bearer。
Media typeapplication/json
object
accessToken
required
string
expiresAt
required
ISO-8601 UTC。Token 有效 24 小時。
string format: date-time
tokenType
required
string
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"}