获取access_token
概述
本系统采用access_token认证机制。access_token是用户的访问令牌,承载了用户的身份、权限等信息。 要获取access_token,需要先联系客服,注册并获取到Secret Key,向获取access_token接口传入Secret Key以换取access_token。
[!WARNING]
- Secret Key永久有效,请注意保存,可以联系客服变更以止损。
- access_token的有效期为7日请注意时间;
- 传入同一个Secret Key进行请求时,会导致之前申请的access_token失效
接口地址
http://api.xvista.cc:9999/oauth/v1/token
请求方法
- POST
请求参数
url参数:
- 此项无参数
Body参数:
{
"grant_type" : "client_credentials",
"client_secret" : "00000000000000"
}
| 参数 | 必选 | 类型 | 值 |
|---|---|---|---|
| grant_type | 是 | string | 固定为client_credentials |
| client_secret | 是 | string | 联系客服获取的Secret Key |
返回示例
成功返回:
{
"code": 1,
"message": "success",
"data": {
"access_token": "0000000000000000000000",
"produce_in": 1750694802,
"expires_in": 604800
},
"timestamp": 1750090002088,
"executeTime": 88
}
| 参数 | 类型 | 值 |
|---|---|---|
| access_token | string | 固定为client_credentials |
| produce_in | long | 生成时间(秒) |
| expires_in | int | 剩余时间(秒) |
[!TIP] 为减少会话,尽量避免生成新的access_token,请注意保存!
除"data"外的其他参数,可以在“通用说明-统一请求响应”中找到说明
错误返回:
无特殊错误,可以在“通用说明-统一异常处理”中找到说明
备注
- 暂无