session_token换取sso_ticket接口

换取用户信息时先调用本接口换取sso_ticket。

请求说明

POST https://{your_domain}/api/v2/tenant/sso/session-token/sso-ticket

请求头

参数名	中文名称	必须	类型	示例
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"
}

请求参数

参数名	中文名称	必须	类型	描述
session_token	用户登录成功后返回的token	是	String
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

{
    "expire": 300, 
    "sso_ticket": "ssoTicket-y0w1ODvy7v0000nCa91OYoj1Bzxqfesy"
}

返回参数

参数名	中文名称	类型	描述
expire	过期时间	Number
sso_ticket	一次性票据	String	根据用户登录后的session_token换取一次性访问票据sso_ticket，sso_ticket可以换取用户信息