中望帐号

使用授权code兑换用户令牌

正式环境

https://accounts.zwsoft.cn

POST

/connect/token

公开

最后修改时间：2023-09-14 07:33:15

通过用户授权code兑换用户令牌（token），用户令牌有效时长为2小时；
刷新令牌有效时长为30天，请注意进行令牌持久化和令牌刷新

不建议在前端进行刷新令牌持久化

请求参数

Body 参数application/x-www-form-urlencoded

client_id

string

客户端ID

必需

示例值:

TestClient

scope

string

可选

作用域，只能为请求用户授权code时的scope子集

示例值:

openid phone email profile offline_access ZMS.UserDetails.Read

redirect_uri

string

必需

回调地址，必须与请求用户授权code时一致

示例值:

https://web.zwsoft.cn/login/callback/

grant_type

string

必需

请求类型，固定值：authorization_code

示例值:

authorization_code

code

string

用户授权code

必需

示例值:

hsxMFWUS0n1-3NRvocXdy3-f2a6gT2afuqr_S19ThLs

code_verifier

string

必需

PKCE校验码，必须是请求用户授权code时使用的code_challenge对应的code_verifier

示例值:

d649tj6k54l8u6d53xc556fse564egr56hj48yt5njm4z89d2s

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://accounts.zwsoft.cn/connect/token' \
--data-urlencode 'client_id=TestClient' \
--data-urlencode 'scope=openid phone email profile offline_access ZMS.UserDetails.Read' \
--data-urlencode 'redirect_uri=https://web.zwsoft.cn/login/callback/' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'code=hsxMFWUS0n1-3NRvocXdy3-f2a6gT2afuqr_S19ThLs' \
--data-urlencode 'code_verifier=d649tj6k54l8u6d53xc556fse564egr56hj48yt5njm4z89d2s'

返回响应

🟢200成功

application/json

Body

id_token

string

用户身份令牌

可选

可用于请求用户基本信息接口

access_token

string

api认证令牌

可选

可用于请求scope对应的api接口，仅scope包含api资源时返回

expires_in

integer

令牌有效时长

必需

单位：秒

token_type

string

令牌类型

必需

固定：Bearer

refresh_token

string

刷新令牌

可选

可用于刷新身份和api认证令牌，仅scope请求offline_access时返回

scope

string

令牌包含的scope

必需

示例

{
    "id_token": "eyJhbGciOiQ-5YnhpEnh9IkzenXQ",
    "access_token": "eyJhbGciB5DZtTWYVqa9A",
    "expires_in": 7200,
    "token_type": "Bearer",
    "refresh_token": "GWV69F9kGdnVM",
    "scope": "openid phone email profile offline_access ZMS.UserDetails.Read"
}

为方便展示，token进行了截取

🟠400请求有误

修改于 2023-09-14 07:33:15

获取用户授权code

刷新令牌