session_token换取sso_ticket接口

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

请求说明

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

请求示例

{
  "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",
  "client_id":"9fIHl3Dc9ivToWLVtblrF6Sjv9Fx47JJ"
}

请求参数

参数名	中文名称	必须	类型	描述
session_token	用户登录成功后返回的token	是	String	用户登录后的session_token换取新的session_token
X-operating-sys-version	调用方操作系统版本	是	String	windows10.1.1
X-device-fingerprint	调用方设备指纹	是	String	156aysdna213sc50
X-device-ip	调用方IP	否	String	192.168.1.2
X-agent	User-Agent信息	是	String	Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15(KHTML, like Gecko) Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace
client_id	应用授权ID	否	String	9fIHl3Dc9ivToWLVtblrF6Sjv9Fx47JJ

返回示例

成功示例

HTTP/1.1 200 OK

{
    "expire":300,
    "sso_ticket":"cd7UWXGMj2jtjLrjr9NxfOA50xIQ5yjn",
}

返回参数

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