Refresh session_token API

Call this API when refreshing session_token.

Request Description

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

Request Headers

Parameter Name	Name	Required	Type	Example
Authorization	Authorization information	Yes	String	Bearer {access_token}
content-type	Content format type	Yes	String	application/json

Request Example

{
    "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"
}

Request Parameters

Parameter Name	Name	Required	Type	Description
session_token	Token after user login	Yes	String	Exchange a new session_token using the session_token after user login
operating_sys_version	Caller client operating system version	Yes	String	Example: windows10.1.1
device_ip	Caller client device IP	Yes	String	Example: 192.168.1.2
device_fingerprint	Caller client device fingerprint	Yes	String	This parameter value needs to remain consistent when the same user calls the API. Example: 156aysdna213sac
agent	User-Agent information	No	String	Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X)

Response Example

Success Example

HTTP/1.1 200 OK

{
    "expire": 43200,
    "session_token": "oRf5WQVfFvIQerrjTlSxTf02MV3pr8n2"
}

Response Parameters

Parameter Name	Name	Type	Description
expire	session_token validity period	Number	session_token validity period; within the validity period, session_token can be used to obtain ticket
session_token	User's new session_token	String	User session_token; this token can be used to call IDaaS APIs to obtain sso_ticket, and sso_ticket can be exchanged for user information