Detailed Description

Get application details

Overview

This API allows users to retrieve the details about the application. This includes contact information, copyrights, trademarks, products installed and licenses consumed.

Since: 12.5

APIs

Method	URL	Description
GET	`/ws/v19/about`	Retrieve application details.

Authentication

Authentication is required. The client must be logged in to call this API. Each API request must contain X-egain-session request header returned by Login API.

Permissions

None

Licenses

The logged in user must have the following licenses:

If logged in user is a department user, the user must have any of the User Licenses.
If logged in user is a partition user, any of the User Licenses must be installed.

Request

Request headers

Name	Description	Allowed values	Default value
X-egain-session	Session ID obtained from Login API response header	N/A	N/A
Accept	Content type accepted by client	`application/xml` or `application/json`	N/A
Accept-Language	Language locale accepted by client (used for locale specific fields in resource representation and in error responses)	Supported 'Accept-Language' header codes	`default system language`

Supported API specific query parameters

None

Supported common query parameters

Refer to Supported Common Query Parameters in ECE REST API page for detailed description of each common parameter listed below.

$attribute - Values of $attribute common parameter supported by About Resource

Response

Response headers

Name	Description	Possible values
X-egain-session	Session ID of the current user session	N/A
Content-Type	Media type of response body	`application/xml` or `application/json`

Response body xml schemas

v19-schema-platform-about - used in case of success
schema-kb-WSError - used in case of error

Summary attributes always returned in server response

Summary attributes of About Resource

Additional attributes returned in server response if explicitly requested by client

Server can be prompted to return additional attributes of resource representation using $attribute common query parameter.
See Values of $attribute common parameter supported by About Resource for the list of allowed attribute names.

HTTP status codes

Success Status codes

200 - OK

The request was successfully executed

Failure Status codes

400 - Bad Request

Unsupported query or common parameter in request URL
Invalid value of common parameter in request URL (e.g., unallowed value of $order, unsupported $attribute value etc.)

401 - Unauthorized

X-egain-session request header is missing
Session is invalid or expired

403 - Forbidden

The user does not have sufficient permissions to view one or more of the requested resources

404 - Not Found

One or more of the requested resource IDs does not exist

406 - Not Acceptable

Invalid 'Accept-Language' header value

500 - Internal server error

Examples:

Example 1 - Get details of the application with summary attributes
Example 2 - Get details of the application with all attributes