通过sso_ticket换取用户信息接口
通过sso-ticket换取用户信息时调用本接口。
请求说明
http
POST https://{your_domain}/api/v2/tenant/sso/sso-ticket/verify请求示例
json
{
"sso_ticket":"ssoTicket-r5TCBLU14oSGxCMVdxeB5HA1uJiV",
"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"
}请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| sso_ticket | 一次性访问票据 | 是 | String | 根据用户登录后的session_token换取一次性访问票据sso_ticket，sso_ticket可以换取用户信息 |
| 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 |
返回示例
成功示例
HTTP/1.1 200 OK
json
{
"code": "0",
"message": "success",
"data": {
"user": {
"name": "20220330162435",
"mobile": "+86-13516486286",
"id": "20220330162436475-7570-D943B4FF3",
"userName": "20220330162435",
"email": "20220330162435@test.com"
},
"id_token": "eyJraWQiOiI0NmI5NjUxYTgwMmU0NjVkOWE4Mjc4YWY4NmRiNDFkMiIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJodHRwczovL2xyLm9uZWFjY2Vzcy1hbHBoYS5iY2Nhc3RsZS5jb20vYXBpL3YxL29hdXRoMiIsImF1ZCI6IllOSDJKRmZmNFo3c1U2UVFERVZ1a0kyVXhKTUxrZHhZIiwiZXhwIjoxNjc1NzU5NTEzLCJqdGkiOiJRQUtkQm44UUFqamg3dmlzVkcyS2ZnIiwiaWF0IjoxNjc1NzU5MzkzLCJuYmYiOjE2NzU3NTkyNzMsInN1YiI6IjIwMjMwMjA3MTYwNzI2NDg0LUNEQUItRUFDNTNCMjlFIiwibmFtZSI6InRlc3RfbmFtZSIsIm1vYmlsZSI6Iis4Ni0xODExMjM0MTIzNCIsImlkIjoiMjAyMzAyMDcxNjA3MjY0ODQtQ0RBQi1FQUM1M0IyOUUiLCJ1c2VyTmFtZSI6InRlc3QiLCJlbWFpbCI6InRlc3RAcXEuY29tIiwidXNlcklkIjoiMjAyMzAyMDcxNjA3MjY0ODQtQ0RBQi1FQUM1M0IyOUUifQ.QK7s4wxw4AUR1lTc4VynUnYVb-IXcBrwWt_A4mLV_2ElfxTgaRvaG4E1U2XgHxBqYtXdbhBlImKVxMs_qmgfWMS7mPq6KT9lUaQ4UBULLSLpWqWQTlJ9Dr96gjmpz6lD3f7tpjUvc8PjcKGiic3B3sCf3PW0WkFhN9eE_C0PHWYPTG0Hdgv6op6HPN-c02KPAfWinb270X5Ga0boQC8JwEte9KwdtJmbS2CYSul1oceBfg2BIcH8oLGfyi_KAZVbwgshFO_YLdbA9YqJ4ZxXrMSPS93PqowaCPoxbFyWiCaeUWSpvGTn_z6at-ntwr4MQ1zfEu2CRJEnQngp8rwP9w"
}
}返回参数
平台默认返回基本的用户列表如下所示
| 参数名 | 中文名称 | 类型 | 描述 |
|---|---|---|---|
| user | 用户信息 | json | 用户信息json对象 |
| - userName | 用户名 | String | |
| - id | 用户ID | String | |
| - name | 姓名 | String | |
| - mobile | 手机号 | String | |
| 邮箱 | String | ||
| id_token | 短期有效，接口调用凭证 | String | 该字段是一个jwt，保存了用户信息，默认2小时有效，支持可配置 |