获取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"外的其他参数,可以在“通用说明-统一请求响应”中找到说明

错误返回:

无特殊错误,可以在“通用说明-统一异常处理”中找到说明

备注

  • 暂无
Copyright & www.xvista.cc 2025 all right reserved,powered by Gitbook该文件修订时间: 2025-06-17 15:41:05

results matching ""

    No results matching ""