Published: 17 Sep 2024

Some attributes are common to both concepts:
id - short and unique concept (test or symptom) id,
name - concept name (professional medical term),
description - detailed description.
Authentication
Diagnosis API uses a custom authentication mechanism. To take advantage of the diagnostic capabilities of Diagnosis API you must describe your patient cases in terms of observations available in the presented model; in other words, you need to know exact Test results and Symptoms to be passed to the /DDxItems endpoint.
For each medical concept category there are two REST-inspired read-only endpoints supporting GET requests:
one returns the list of all Lab Tests Procedures (https://diagnosisapi.azurewebsites.net/api/DDxItems/GetTests?AuthenticationID=DEMO_AuthenticationID),
the other returns the list of all possible Symptoms (https://diagnosisapi.azurewebsites.net/api/DDxItems/GetSymptoms?AuthenticationID=DEMO_AuthenticationID).
Each concept is represented by a JSON object with several attributes. This parameter corresponds to your unique application ID. We will provide you with your unique AuthenticationID after registration.
An example of a request could look like this (finally you will replace DEMO_AuthenticationID with your credentials):
'https://diagnosisapi.azurewebsites.net/api/DDxItems/?AuthenticationID=DEMO_AuthenticationID'
Base Health Terms
Diagnostic information recognized by the API engine is categorized as Lab Test Procedures and Symptoms. Each request must include non-standard HTTP header: AuthenticationID. For your Demo Development you can use AuthenticationID = DEMO_AuthenticationID.

Then GET Possible Health Conditions from the Diagnosis API.
In order to achieve best results and enable more features of the API, you have to provide as many test result and symptoms as possible. We have created a sample 'Diagnosis API' collection for you. Also the patient has list of implemented Lab Test Procedures: ALT, Amalyse, AST, Total Bilirubin, GT Chlamydia, Appearance Urine, and ABO grouping. Let's assume we have a patient, suffering from strong smell urine, frequent urination and yellow skin. Diagnosis API is available as the Postman collection. The collection located: https://postman.com/collections/7445d89fda1d633e08dd. The collection includes some endpoints and predefined requests that you can extend. By entering and identified the tests values you can send (POST) both Symptoms and Tests lists to https://diagnosisapi.azurewebsites.net. Each observation is represented by a unique ID; in this case the symptom IDs are 164, 151 and 200, respectively. It allows you to test the API in seconds. This will depend on the accuracy of the diagnoses obtained.