Clinical Decision Support System

What is a Medical API?

A medical API (Application Programming Interface) is a central repository of various types of medical data. These APIs provide access to information about drug interactions, common symptoms of diseases, and treatment options.

How does a Medical API work?

Medical APIs vary in their functionality. Users can access information by providing symptoms to receive possible diagnoses. For example, a parent seeking advice on caring for a sick child may consult an online medical app that utilizes an API to provide relevant information.

The DdxHub API

The DdxHub Diagnosis API allows users to input a patient's symptoms and receive a list of potential diagnoses. The API provides access to official information about medications and medical devices from authoritative agencies worldwide.

Demo Setup

To use the Demo Environment, set AuthenticationID to DEMO_AuthenticationID. To access the diagnostic capabilities of the API, provide patient case data using terms defined in the available schema (i.e., specific Test Results and Symptoms) to the /DDxItems endpoint.

REST API Endpoints

The API offers two REST-inspired read-only endpoints for retrieving medical concepts:

- GetTests endpoint returns a list of all Lab Test Procedures (e.g., https://diagnosisapi.azurewebsites.net/api/DDxItems/GetTests?AuthenticationID=DEMO_AuthenticationID)
- GetSymptoms endpoint returns a list of all possible Symptoms (e.g., https://diagnosisapi.azurewebsites.net/api/DDxItems/GetSymptoms?AuthenticationID=DEMO_AuthenticationID)

Authentication

The Diagnosis API uses a custom authentication mechanism. Each request must include a custom HTTP header: AuthenticationID. You will receive your unique AuthenticationID upon registration.

Example Request

```
https://diagnosisapi.azurewebsites.net/api/DDxItems/?AuthenticationID=DEMO_AuthenticationID
```

Base Health Terms

Diagnostics recognized by the API engine are categorized as Lab Test Procedures and Symptoms.