客户身份(CIAM)

通过sso_ticket换取用户信息接口

通过sso-ticket换取用户信息时调用本接口。

# 请求说明

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

# 请求头

参数名 中文名称 必须 类型 示例
Authorization 授权信息 String Bearer {access_token}
content-type 内容格式类型 String application/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"
}
1
2
3
4
5
6
7

# 请求参数

参数名 中文名称 必须 类型 描述
sso_ticket 一次性访问票据 String 根据用户登录后的session_token换取一次性访问票据sso_ticket,sso_ticket可以换取用户信息
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
{
	"id": "20220126153857263-A04D-60E0D446C",
	"userName": "zhangsan",
    "name": "zhangsan",
    "mobile": "+86-18310136755",
	"email": "18310136755@163.com"
}
1
2
3
4
5
6
7
8
9
10

# 返回参数

平台配置返回基本的用户列表,参考如下

参数名 中文名称 类型 描述
userName 用户名 String
id 用户ID String
name 姓名 String
mobile 手机号 String
email 邮箱 String