中望帐号

密码模式获取用户令牌

正式环境

https://accounts.zwsoft.cn

POST

/connect/token

最后修改时间：2024-04-11 01:47:49

客户端必须为后端服务（由于密码模式需要客户端存储用户名和密码，一般只用于后端服务）

用户令牌有效时长为2小时；
刷新令牌有效时长为30天，请注意进行令牌持久化和令牌刷新

请求参数

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

client_id

string

客户端ID

必需

示例值:

testAutoClient

client_secret

string

客户端密码

必需

示例值:

testAuto.2022

scope

string

作用域

必需

示例值:

openid profile email phone offline_access ZMS.UserDetails.Read

grant_type

必需

请求类型，固定值：password

示例值:

password

username

string

必需

用户名\手机号\邮箱

示例值:

testUserName

password

string

用户密码

必需

示例值:

Abc.123456

示例代码

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=testAutoClient' \
--data-urlencode 'client_secret=testAuto.2022' \
--data-urlencode 'scope=openid profile email phone offline_access ZMS.UserDetails.Read' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'username=testUserName' \
--data-urlencode 'password=Abc.123456'

返回响应

🟢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 profile email phone offline_access ZMS.UserDetails.Read"
}

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

修改于 2024-04-11 01:47:49

受信客户端获取令牌

获取用户基本信息(OIDC)-不建议使用