Using the API
You can access and use the API endpoint URI (https://api.redislabs.com/v1
) with any of the following tools:
- The Swagger user interface
- The cURL HTTP client
- An HTTP client in any programming language
Swagger user interface
The Swagger UI is useful for initial introduction and for learning about API operations, models and simulated usage.
Authenticating to Swagger
To authenticate to the Swagger UI:
-
Open the Swagger UI page in a browser.
-
Click
Authorize
.The Available Authorizations box is shown with the headers and values that are used for authentication in all API interactions with Swagger.
-
Insert the API Key values:
- Enter the Account Key as the
x-api-key
value and click Authorize. - Enter the Secret Key as the
x-api-secret-key
value and click Authorize. - Click Close.
- Enter the Account Key as the
When authorization is successful the lock icon appears as a closed lock.
Making API requests
After you complete the authorization in the Swagger UI, you can make an API request:
-
Open an action category and select an API operation.
For example, in the
Account
category select theGET /payment-methods
operation. -
Click Try it out and Execute.
The API response is shown in the Responses section of the API operation. The results include an example of how you to execute the same operation in a standard command-line utility using
cURL
.
Inputs for operations in Swagger
Some API operations require input, such as:
-
Parameters - When an API operation requires URI parameters, such as “get subscription by subscription id”, you can enter the values for the parameters.
-
JSON Request Body - For API operations that require a JSON request body, you can either:
-
Use the model display to write the request based on the expected JSON structure and parameters.
-
Use the Try it now sample JSON created by Swagger as a base template that you can edit and execute.
-
POST
and PUT
operations. You can reference these examples and modify them to fit your specific needs and account settings. The examples will fail if used as-is. Use the how to articles for more examples of Cloud API operations.Using the cURL
HTTP client
cURL
is a popular command line tool used to perform HTTP requests,
either as individual commands or within shell scripts (mostly Linux Bash).
For an introduction to cURL
, see How to start using cURL and why: a hands-on introduction.
cURL
and Linux shell scripts to provide examples on using the API.For example, a standard API call to get System Log information looks like this in cURL
:
curl -s -X GET "https://$HOST/logs" \
-H "accept: application/json" \
-H "x-api-key: $ACCOUNT_KEY" \
-H "x-api-secret-key: $SECRET_KEY" \
| jq -r .
-
The example expects several variables to be set in the Linux shell:
- $HOST - The URI of the Redis Labs API (
api.redislabs.com/v1
) - $ACCOUNT_KEY - The Account key value
- $SECRET_KEY - The personal secret key value
- $HOST - The URI of the Redis Labs API (
-
The line “
| jq -r .
” means that the HTTP response will be piped (forwarded) to thejq
JSON command-line processor, and it will display only the raw output (“-r
”) of the root element (“.
”) -
You can set the variables using shell commands like the following:
export HOST=api.redislabs.com/v1
export ACCOUNT_KEY={replace-with-your-account-key}
export SECRET_KEY={replace-with-your-secret-key}