客户身份(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

# 请求参数

参数名 中文名称 必须 类型 描述
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

# 返回参数

参数名 中文名称 类型 描述
expire session_token有效期 Number session_token有效期,有效期内可使用session_token获取ticket
session_token 用户新的session_token String 用户session_token,可使用该token调用IDaaS接口获取sso_ticket,sso_ticket可以换取用户信息