Product Documentation

REST Web Services

Jun 14, 2016

REST (REpresentational State Transfer) is an architectural style based on simple HTTP requests and responses between the client and the server. REST is used to query or change the state of objects on the server side. In REST, the server side is modeled as a set of entities where each entity is identified by a unique URL.

For information on the NITRO SDKs, see Java, .NET, and Python API.

The general format for NITRO URLs is as follows:

  • For configurations. http://<netscaler-ip-address>/nitro/v1/config/<resource-type>
  • For retrieving statistics. http://<netscaler-ip-address>/nitro/v1/stat/<resource-type>

For example, for a load balancing virtual server, <resource-type> can be replaced by lbvserver.

Important

From NetScaler 10.1 version onwards, the following Content-Type is supported:

Content-Type:application/vnd.com.citrix.netscaler.<resource-type>+json.

However, content types such as "application/x-www-form-urlencoded" that were supported in NetScaler 9.3 and earlier versions can also be used. You must make sure that the payload is the same as used in earlier versions.

The payloads provided in this documentation are applicable only for the "application/vnd.com.citrix.netscaler.<resource-type>+json" Content-Type.

Some points to remember:

  • In addition to the CRUD operations (Create, Read, Update, and Delete), resources (such as lbvserver) can support other operations or actions. These operations use the HTTP POST method, with the URL specifying the operation to be performed and the request body specifying the parameters for that operation.
  • All NITRO operations are logged in the /var/log/nitro.log file on the NetScaler appliance.

For more information on the REST objects and the usage, see the documentation provided in the <NITRO_SDK_HOME>/index.html file.