客户身份(CIAM)
刷新session_token接口
刷新session_token时调用本接口。
# 请求说明
POST https://{your_domain}/api/v2/tenant/sso/session-token/refresh
# 请求头
参数名 | 中文名称 | 必须 | 类型 | 示例 |
---|---|---|---|---|
Authorization | 授权信息 | 是 | String | Bearer {access_token} |
content-type | 内容格式类型 | 是 | String | application/json |
# 请求示例
{
"session_token":"iJKVWQVfFvIQWffsTlSxTf02MV3dpITu",
"operating_sys_version":"windows10.1.1",
"device_ip":"192.168.1.1",
"device_fingerprint":"156aysdna213sac",
"agent":"agent:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 请求参数
参数名 | 中文名称 | 必须 | 类型 | 描述 |
---|---|---|---|---|
session_token | 用户登录后的token | 是 | String | 用户登录后的session_token换取新的session_token |
operating_sys_version | 调用方客户端操作系统版本 | 是 | String | 例如: windows10.1.1 |
device_ip | 调用方设备ip | 是 | String | 例如: 192.168.1.2 |
device_fingerprint | 调用方客户端设备指纹 | 是 | String | 同一个用户调用接口时该参数的值需保持统一。 例如: 156aysdna213sac |
agent | User-Agent信息 | 否 | String | Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) |
# 返回示例
成功示例:
HTTP/1.1 200 OK
Content-Type: application/json
{
"expire": 43200,
"session_token": "oRf5WQVfFvIQerrjTlSxTf02MV3pr8n2"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 返回参数
参数名 | 中文名称 | 类型 | 描述 |
---|---|---|---|
expire | session_token有效期 | Number | session_token有效期,有效期内可使用session_token获取ticket |
session_token | 用户新的session_token | String | 用户session_token,可使用该token调用IDaaS接口获取sso_ticket,sso_ticket可以换取用户信息 |