Authentication

MD Live uses JWT Web Tokens to allow access to our API endpoints.

We grant two types of tokens. The type needed depends on the endpoints that you would like to access.

Endpoints that:	Can use:
do not require a patient id	API token
require a patient id	User token

MD Live expects for the token to be included in all API requests to the server in a header that looks like the following:

Authorization: Bearer {jwt_token}

Note

Always include ‘Bearer’, and you must replace {jwt_token} with your token obtained from one of the token endpoints.

Note

MD Live expects all authentication request to include valid API credentials. To obtain credentials, please reach out to your Account Manager.

Example Request

Shell

# With shell, you can just pass the correct header with each request
curl "api_endpoint_here"
  -H "Authorization: Bearer {jwt_token}"

Ruby

# With ruby, you can can add correct header to the request object
RestClient::Request.new(
  :method => :get,
  :url => "sample_url",
  :headers => {
    'Authorization' => 'Bearer {jwt_token}'
  }
).execute

Make sure to replace {jwt_token} with your JWT Token.