说明

提示

• 通过在HTTP请求中指定app_id和app_secret来获取访问令牌。
• grant_type固定传client_credentials。
• 返回的令牌是调用所有其他API接口必传的。
• 访问令牌的有效期通常为2小时。参考expires_in获取实际的令牌过期时间。
• 开发者需要维护好令牌的失效时间，如果超时了，需要重新进行获取。

接口地址

/oauth/api/v1/token

请求方式

POST

body请求参数

参数名	说明	是否必填	最大长度	示例
app_id	开发者唯一标识	是	32	7520b82387784
app_secret	开发者密钥	是	32	2039964434a08828828be16ef454f485
grant_type	授权方式	是	32	client_credentials

返回参数

参数名	说明	最大长度	示例
access_token	令牌	1024	eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
expires_in	过期时间	16	1697447592690
refresh_token	刷新令牌	1024	eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
refresh_token_expires_in	刷新令牌过期时间	16	1697195592690

请求示例

{
  "app_id": "7520b82387784",
  "app_secret": "2039964434a08828828be16ef454f485",
  "grant_type": "client_credentials"
}

curl --location --request POST '{baseUrl}/oauth/api/v1/token' \
--header 'Request-Id: 1697189440982' \
--header 'Sign: uqMPDt0ZUghN7/wUxswAV7EzCLsX0V3WEyTAyC55qnDAm0S5l7mGQCMgj4s3j0AXt58i8DKDyXMI2zvDCb9A5Q4CUhXricUAdKVH3+YPCmjG2kCvTfwFt9o78vTGwv1VbaedOsvp6goBcLdeRSU4Aiac/sabxemhjZE+8Qom7BY=' \
--header 'X-Timestamp: 1697189440233' \
--header 'Content-Type: application/json' \
--data-raw '{
  "app_id":"15696412709535895041",
  "app_secret":"bc2ead7739f447c49032b4aef7818c46",
  "grant_type":"client_credentials"
}'

// Make sure to add code blocks to your code group

返回示例

{
  "trace_id": "3c5be383841a0e9d",
  "code": "SUCCESS",
  "data": {
      "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRJZCI6IkNUMjIwNzI4MTU2MDAwMTQiLCJhY2Nlc3NUb2tlbkV4cGlyZWQiOjE2OTcxOTU1OTI2OTAsImFwcElkIjoiMTU2OTY0MTI3MDk1MzU4OTUwNCIsInVuaXRJZCI6IlVUMjIwODE3MTU2MDEwNzgiLCJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJvcmdDbGllbnRJZCI6IkNUMjIwNzI4MTU2MDAwMTQiLCJvcmdVbml0SWQiOiJVVDIyMDgxNzE1NjAxMDc4In0.kEouiUWgR-2M3nOA3POEYnVluWGTi2_I3ghYTGHpYrs",
      "refresh_token_expires_in": 1697447592690,
      "refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRJZCI6IkNUMjIwNzI4MTU2MDAwMTQiLCJhY2Nlc3NUb2tlbkV4cGlyZWQiOjE2OTc0NDc1OTI2OTAsImFwcElkIjoiMTU2OTY0MTI3MDk1MzU4OTUwNCIsInVuaXRJZCI6IlVUMjIwODE3MTU2MDEwNzgiLCJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJvcmdDbGllbnRJZCI6IkNUMjIwNzI4MTU2MDAwMTQiLCJvcmdVbml0SWQiOiJVVDIyMDgxNzE1NjAxMDc4In0.W6-f01j1rcrIrVIRsLa2yY-TSX5OBxuUG1ugJMdqTzg",
      "expires_in": 1697195592690
  },
  "success": true,
  "message": null
}

{
  "trace_id": "604a5bdacf6f0e90",
  "code": "B_Sign_InvalidError",
  "success": false,
  "message": "app_id is invalid"
}

// Make sure to add code blocks to your code group