TSWS logout


The TrueSight Web Service (TSWS) token API (DELETE) is meant for terminating a user session identified by an authToken. It uses the DELETE method to invalidate the authToken received in the request header.

TSWS API that use the POST method

API Endpoints

Description

Obtains the authToken required to perform all other operations

Request syntax

https://<PresentationServerHostName>/tsws/api/v10.1/token

Sample request with REST client

 After accessing the REST client, perform the following steps:

  1. Enter the URL for the configuration data of monitor instances API. The generic format is:
    https://<Presentation Server host name>/tsws/api/v10.1/token
  2. Add a new header row and select authToken as the header type.
  3. Enter the text authToken followed by the authToken generated through the token API (POST). 
    The request body is blank.
  4. Select the method type as DELETE.
  5. Click Send.

Request parameters

 

Element

Description

authToken

Value of the authToken

 

Sample request with REST client

rest_logout_110.png

JSON response content

The JSON response includes a status code to indicate whether the request succeeded or failed.

Object

Description

status

Value returned as OK <Check with Suhas for the value>.

Sample JSON response and troubleshooting authentication API

The response information follows the standard HTTP response status codes. The following table contains Sample JSON response and the associated troubleshooting tips:

Status code

Description

Sample JSON

Troubleshooting tips

200

Success

{
   "responseTimeStamp": "2017-05-08T19:29:18",
   "statusCode": "200",
   "statusMsg": "OK",
  "response":
   {"authPassed":true,"status":"OK"}
}

Not applicable.

401

Invalid/expired token

{
  "responseTimeStamp": "2017-05-09T01:24:43",
  "statusCode": "401",
  "statusMsg": "Invalid/expired token",
  "response":
   {"authPassed":true,"status":"OK"}
}

Specify a valid authToken and try again.

500

Internal Server error

{
 "responseTimeStamp": "2017-05-09T01:25:35",
 "statusCode": "500",
 "statusMsg": "Internal Server error",
  "response":
   {"authPassed":true,"status":"OK"}

Try after some time or contact the TrueSight Presentation Server administrator.

503

Remedy SSO is not accessible

{
"responseTimeStamp":"2017-05-15T14:41:40",
"statusCode": "503",
"statusMsg": "Remedy SSO server is not accessible",
  "response":
   {"authPassed":true,"status":"OK"}

Try after some time or contact the TrueSight Presentation Server administrator.

Related topics

Developing

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*