Organizations, other than those using with the Starter or Pilot Editions, that wish to access their information can do so via RESTful Application Programming Interfaces (RESTful APIs) after securing an account and attaining their unique identifier (Tenant ID). If you do not have an account please bother us so we can get started immediately. The list of product APIs resides here.
We are always looking to add value to our Products so do not hesitate to bother us to help integrate your information into your product or a Commercial-Off-The-Shelf (COTS) product. As well, we are always looking for add to our product so forward your suggestions and if we add it to a future version you will get some cool swag.
Using Our APIs
The first parameter to any call is the TenantID field, which identifies your organization and controls the data you can retrieve. Besides the data you are seeking to retrieve, all calls will return the following information.
|200||OK||Resolved the get request successfully and the body contains the response.|
Everything is working
|201||OK||New resource has been created|
|204||OK||The resource was successfully deleted|
|400||Bad Request||Either required headers are missing or the body of the JSON is malformed.|
The request was invalid because of a missing or invalid parameter from client-side code
|401||Unauthorized||The request requires an user authentication. Likely the client-side code is using the incorrect Tenant ID|
|403||Forbidden||The caller is not authorized to perform this operation.|
The server understood the request, but is refusing it or the access is not allowed. Examples: Tenant ID is wrong or not provided.
|404||Not Found||Subscription not found with the given ID|
The requested resource does not exist
|422||Unprocessable Entity||Should be used if the server cannot process the enitity, e.g. if an image cannot be formatted or mandatory fields are missing in the payload|
|500||Internal Server Error||Unexpected problem on server side (Our Microsoft Azure instance)|
|503||Service Unavailable||Service is down temporarily, retry later.|
Unexpected problem on server side (Our Microsoft Azure instance)
To access demo data, simply click on any of the links second table above. You will be able to utilize all of our APIs but with read only access.
Tip: You should store the TenantID as a parameter to the application, rather than hard-code it into the API calls.
We utilize the same return codes that one would expect with HTTP. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed because of the provided information, and codes in the 5xx range indicate very rare error due to issues within our Microsoft Azure instance.
|Success||Boolean||Value indicating whether the call worked|
|StatusCode||Integer||HTTP response code|
|Count||Integer||Number of data elements|
|Message||String||Short description of object|
|Data||Object or Collection||The actual data object or collection from the API call|