Use HTTP GET and POST requests to query the Ringtail Connect API

You can query the Ringtail Connect API using HTTP GET and POST requests. This allows you to build custom applications that request data directly from Ringtail.

The Ringtail Connect API connects using HTTP and consumes data in JSON format.

A GraphQL operation returns data as a JSON object. The structure of a response mirrors the structure of an operation.

Tip: You can create and test queries in the API explorer before running queries in a third-party application. For more information about the API explorer, see Access and use the Ringtail Connect API Explorer.

Before you start

Before you start, do the following:

●Obtain your Ringtail API token and API key from your system administrator. Your token and key authenticate you. For more information, see Obtain an API token and key for a user.

Caution: Store your API token and key in a secure location, the same way that you protect your password. Anyone who has your token and key can access all of the data that you can access through the API.

●Obtain the URL of the API service for the portal from your system administrator. The URL of the API service is available in the Portal Management area, in the Settings section, on the Portal Options page. For more information, see Ringtail Connect API URL.

GET requests

HTTP method: GET

Resource URL: URL of the API service for the portal, such as http://ringtail.com/Ringtail-Svc-Portal/api/query. For more information, see Before you start.

HTTP headers:

Header	Required?
Authorization: bearer yourAPIToken	Required
ApiKey: yourAPIKey	Required

Parameters:

Parameter	Required?	Description
query	Required	The query to run. Encode the query as valid ASCII format, so that it can be passed as part of a URL.
variables	Optional	The variables in the query. Encode the variables as valid ASCII format, so that it can be passed as part of a URL.

Request body: Not applicable.

POST requests

HTTP method: POST

Resource URL: URL of the API service for the portal, such as http://ringtail.com/Ringtail-Svc-Portal/api/query. For more information, see Before you start.

HTTP headers:

Header	Required?
Content-Type: application/json	Required
Authorization: bearer yourAPIToken	Required
ApiKey: yourAPIKey	Required

Parameters: Not applicable.

Request body:

Parameter	Required?	Description
query	Required	The query to run, formatted as valid JSON syntax.
variables	Optional	The variables in the query, formatted as valid JSON syntax.

top