How to invoke API
Use the API Exploration for a quick demo.
All the query parameters are available for other access methods mentioned in Data Access Methods
Example 1: step by step to invoke the API
Use the Get Sessions as an example.
Step 1. Choose the URL based on your region and click Invoke API.
Step 2. Click Authorize and fill in the Client ID and Client secret, then click the Generate.
Refer to the Get started with Citrix Cloud APIs section to create the Client ID and Client secret.
Step 3. Click Authorize. The authorization key is automatically appended to the API authentication request.
Step 4. Fill in the header parameters.
- Citrix-CustomerId: Your customerID
- Authorization: Automatically appended in Step3, no need to change.
- User-Agent: Automatically filled, no need to change.
- Accept: Automatically filled, no need to change.
- Accept-Encoding: Automatically filled, no need to change. Encoding can reduce bandwidth, saving on costs.
Step 5. Fill in the query parameters.
- $filter: Filter the results using OData syntax. Please use the indexed fields for better performance.
- $orderby: Order the results using OData syntax.
- $top: Limit the number of results returned. Here is 1 for sample, please adjust or remove it as needed.
- $skip: Skip the number of results.
- $count: Include the count of results.
- $select: Select the fields to return. Use this operation to return the required fields, reducing bandwidth and saving on costs.
- $expand: Expand the fields to return. The example value and schema in the response show the result after using the expand operation. Without the expand operation, only the current entity will be displayed, and the related entities will not be shown.
Step 6. Click the execute then check the reponse.
All the query parameters will be shown in the Request URL
Example 2: the $count operation
With $count=true in the query parameter.
The response will contains the count filed @odata.count.
Example 3: the $select operation
With $select in the query parameter.
The response will only return the selected fileds.
Example 4: the $expand operation
With $expand in the query parameter.
The response only return the expand fileds.
