获取访问凭证令牌

开发中

GET

http://prod-cn.your-api-server.com/api/justauth/generate/v1/visitor/token

最后修改时间：2025-02-20 08:56:54

责任人：未设置

返回值 token-JWT内容含义

字段	含义
name	用户登录名
sub	用户id
tenant	租户id
client_id	密钥key
server	是否服务
exp	过期时间(时间戳)
scope	授权范围
flag	用户类型(管理员=1,员工=2,客户=4)
iat	颁发时间

💡

JWT默认有效时间7个小时，可依据exp字段判断出有效时间。建议缓存，时效小于有效时间(例如 exp-当前时间戳-半小时=缓存失效时间)，jwt过期，重新请求接口获取

状态码

参考：错误码

💡

令牌过期状态码: 401

请求参数

Query 参数

appid

string

AppKey

必需

sign_method

string

签名算法

必需

sign

string

签名内容

必需

timestamp

string

必需

时间戳,必须在20分钟之内,（毫秒级）

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://prod-cn.your-api-server.com/api/justauth/generate/v1/visitor/token?appid=&sign_method=&sign=&timestamp='

返回响应

🟢200成功

application/json

Body

token

string

必需

令牌。JWT默认有效时间7个小时，可依据exp字段判断出有效时间。建议缓存，时效小于有效时间(例如 exp-当前时间戳-半小时=缓存失效时间)

示例

{
  "msg": "appid, timestamp, formSign, signMethod为必填字段",
  "code": 500,
  "status": "VALIDATE_FAILED"
}

🟠400400响应结构

修改于 2025-02-20 08:56:54

响应信息

通讯录同步

获取访问凭证令牌

返回值 token-JWT内容含义#

状态码#

请求参数

示例代码

返回响应

返回值 token-JWT内容含义

状态码