API Overview

REST APIs allow you to retrieve and collect useful system information from Citrix Smart Tools database. You can also perform some basic management functions using the REST APIs.

The global URL to access any API is httpsː//<servername>/<supported_version>/. The server name will change depending on the environment. Current supported version is v0. For example, https://smart.cloud.com/v0/.

By default, every string passed to and from is UTF-8 encoded. Some of them are Base64 encoded. Each API in the API Reference section explicitly specifies which field is base64 encoded.

Before you access any API, ensure that you have the apikey and apisecret key. The client can not use same username and password used to access the Citrix Smart Tools UI. You can interchange apikey and secret key also as client_id and client_secret for OAuth2 authentication purposes. After successful authentication every API must have a parameter access_token, which contains a valid token generated by authentication.

The system will respond with an HTTP error code, if an invalid or incorrect API is passed. The following table describes some of the HTTP status error codes:

Error Code Description Resolution
400

Bad input parameters or error messages.

Ensure correct input parameters are provided.

401

Bad credentials or expired token. 

Ensure valid authentication credentials are used.

404

Bad API name. 

Ensure the correct API is passed.

500

Internal server error. This happens only if errors are not handled properly on the server. 

Ensure errors are properly handled at the internal server.

Related Topics

API Reference

0 Comments