Authenticate

All OpenAPI requests require a token. Read more here about how to retrieve the authorization token. Supply token and application id within header.

Header Elements

Application Id

Header Key ApplicationId
Format ApplicationId: 4C782603-8B36-485A-AE33-557CF6392E44
Description Supplied to you by your InteliChart representative

Authorization

Header Key Authorization
Format Authorization: Bearer 0123456789ABCDEFGHIJ0123456789ABCDEFGHIJ0123456789ABCDEFGHIJ
Description Token is passed in the authorization header value

 

Body Elements

The body of the authenticate request requires the Application Id, PassCode and Date of Birth for the user.

Application Id

Header Key ApplicationId
Format ApplicationId: 4C782603-8B36-485A-AE33-557CF6392E44
Description Supplied to you by your InteliChart representative

Passcode

Header Key PassCode
Format PassCode: ABC123
Description Patient received from doctor and input into your application

Date of Birth

Header Key DateOfBirth
Format DateOfBirth: 01/01/1945
Description Patient's date of birth

Sample Request

POST https://openapitest.intelichart.com/api/server/authenticate HTTP/1.1 
Authorization: Bearer 0123456789ABCDEFGHIJ0123456789ABCDEFGHIJ0123456789ABCDEFGHIJ 
ClientID: 4C782603-8B36-485A-AE33-557CF6392E44 
Content-Type: application/json 
Content-Length: 120
{
    "ApplicationId": "4C782603-8B36-485A-AE33-557CF6392E44",
    "PassCode": "ABCDEFG",
    "DateOfBirth": "01/01/1945"
}

Sample Response

The returned response, if successful, contains the encrypted person user identifier (PersonUid). This identifier should be saved in your database. It is required in all subsequent calls to retrieve clinical and demographic information about the patient.

HTTP/1.1 200 OK
Pragma: no-cache
Content-Length: 64
Cache-Control: no-cache
Content-Type: application/json
Date: Thu, 23 Feb 2017 01:24:02 GMT
{
    "PersonUid": "iedrH0BMe9VoOY8Poeb7vg==jS3dh3VKntyAPFYSPkY1TA=="
}