Help Center/ KooDrive/ API Reference/ API/ Session Management/ Checking Whether a User Session Is Invalid Based on Token Information

Updated on 2024-07-30 GMT+08:00

View PDF

Checking Whether a User Session Is Invalid Based on Token Information

Function

Check whether a user session is invalid based on token information.

URI

GET /koodrive/ose/v1/session/auth

Request Parameters

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
Authorization	Yes	String	Access token. Token authentication is used to call KooDrive APIs. A token indicates the permission. When an API is called, the token is added to the request header to obtain the operation permission. For details about how to obtain an access token, see the corresponding developer guide. The format is Bearer+{access_token}.
X-Traceid	No	String	Message log trace ID. The value contains 58 bits.
language	No	String	Language code, which complies with the internationalization specifications. For example, en-US indicates English (United States). English (United States) is used by default.

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
code	String	Error code.
msg	String	Error message.
data	OrgUserInfo object	User information.

**Table 3** OrgUserInfo
Parameter	Type	Description
role	Integer	Role. 0: common administrator. 1: common user. 2: super administrator.
innerUserId	String	Internal user ID.
userName	Long	Internal user ID.
orgId	String	orgId
orgName	String	Name in OrgID.
tenantId	String	Tenant code, that is, enterprise code.
userCount	String	Number of users.
deptId	String	Department ID.

Example Requests

Request for verifying a token.

GET /koodrive/ose/v1/session/auth

Authorization:Bearer+10f88**********4791e9ff

Example Responses

Status code: 200

User information.

{
  "data": {
    "role": "2",
    "userName": "Tenant Administrator",
    "innerUserId": "369528171409614001",
    "userId": "1008600000016806899",
    "tenantId": "40086000004871666",
    "orgId": "9190086000001210958",
    "orgName": "KooDrive", 
    "deptId":1395496464656556464
    "userCount": 7000
  },
  "code": 0,
  "msg": "success"
}