Prognosis REST API

The Prognosis REST APIs are available for developers and system administrators who wish to integrate Prognosis data into 3rd party applications or to provide limited configurations of the Prognosis server using scripts or customer developed applications.

This REST API provides access to Prognosis resources using standard HTTP requests and requires the responses to be parsed using either of the 2 supported output formats, JSON or XML.

This document summarizes the REST data API available in Prognosis. It documents the method calls and request & response formats, because REST is based on open standards, it is possible to use any development language to access the API.

Current REST Version

The current version for the Prognosis REST API is "v1".

Where {ver} is specified within these pages, it should be replaced with "v1".

REST Resources

Request Parameters

Within the REST API pages, each method specifies the parameters required for each request, these parameters can be one of the following

URLThese parameters are specified in the URL and identify a resource on the server to request against.
QueryThese parameters are specified in the URL in the Query String part of the URL.  i.e. following the '?'. They are always a <key>=<value> pair. The key is the name of the parameter, the value must be supplied.
Body

This is the payload of the request, and the format is based on the content-type of the request. Prognosis supports only 2 types, application/xml and application/json

These parameters must be supplied in the payload, see next section for examples.

Authorization and Security

Access to the Rest API is restricted to users as defined in the Web Application - Administration 'Security' configuration. The authenticated user must belong to a defined Role. The Role will specify the permissions and features available to the user.

The documented API's will provide details of the permissions required to use each REST function call.

Two modes of authentication are supported, one of these must be used:

  • HTTP Basic authentication for 3rd party client calls outside the context of Prognosis (via 'Authorize' HTTP header).
  • Web session as supported by the Prognosis Web Application (via Forms authentication - ie, log into the Prognosis Web Application from the browser).  If the Rest API request contains the cookie that belongs to the existing Prognosis Web Application session, the cookie will be accepted and the role will be recognized and authenticated.

Error Handling and Debugging

The Prognosis REST API follows RFC 2616 for error handling. Prognosis also provides logging for the REST API calls and can be found in <Prognosis_Home>\WebUI\IIS\Logs.

Swagger Interface

The Swagger interface provides an easy way to test and use the Prognosis API's. This interface is accessible after logging in to the Prognosis Web Application and then modifying the browser URL Address to:

https://<prognosis-server>/Prognosis/swagger

For details about using Swagger please refer to the Swagger web site: http://swagger.io


Provide feedback on this article