帮助文档

生成客户端令牌

POST

https://api.maxhub.com/pivot/api/open/v5/auth/token

请求参数

Query 参数

grant_type

string

必需

固定值：client_credentials

示例值:

client_credentials

Header 参数

X-Isp-Code

string

必需

组织码，获取路径：领效星云管理页面-> 我的企业 -> 企业ID

示例值:

Authorization

string

必需

1.需要使用 base64 编码 (appId:appSecret)!!!不要直接复制base64(appId:secret), 可以在https://tool.oschina.net/encrypt?type=3在线base64编码。 2.请求时请不要忘记带上 "Basic " 3.appId 获取方式：领效星云管理后台->我的企业->第三方对接->接口授权-> Access Key，appSecret 领效星云管理后台->我的企业->第三方对接->接口授权-> Access Secret 示例值: Basic base64(appId:appSecret)

X-Isp-TraceId

string

必需

请求ID, 随机生成的32位uuid

示例值:

X-Auth-Sign

string

必需

签名，规则参考参数验签生成规则

示例值:

X-Auth-Timestamp

string

必需

请求发送的毫秒时间戳

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.maxhub.com/pivot/api/open/v5/auth/token?grant_type=client_credentials' \
--header 'X-Isp-Code: {{sign_orgCode}}' \
--header 'Authorization;' \
--header 'X-Isp-TraceId: {{uuid}}' \
--header 'X-Auth-Sign: {{sign}}' \
--header 'X-Auth-Timestamp: {{timestamp}}'

返回响应

🟢200成功

application/json

Body

code

number

返回码

必需

data

object

返回数据

必需

access_token

string

客户端令牌

必需

token_type

string

令牌类型

必需

expires_in

number

必需

令牌有效期，单位秒；一般为7200，即2小时

message

string

返回信息

必需

示例

{
  "code": "200",
  "data": {
    "access_token": "698249b0-2893-4171-adde-2074522aeea0",
    "token_type": "bearer",
    "expires_in": 7200
  },
  "message": "ok"
}

修改于 2025-03-18 06:25:40

最佳实践 - 代码实现参考（JAVA）

手机号免密登录授权