MedTel API

MedTel’s platforms are fully compatible to your existing systems. Developer teams from our partners can use our APIs to get the data they want for integration and analytics, the way they need.

This is a very concise document explaining how to generate consultations and extract consultation, POC test data from our systems.

For further details please contact us at board@medtel.in

API Reference

Introduction

Authentication

Paths

Generate Consultation

Get Consultation Data

Get POC Test Data

API Endpoint
https://api.medtel.in/api/{path}
Terms of Service: https://medtel.io/terms-conditions/
Contact: board@medtel.in
Schemes: https
Version: 2.0

Introduction

This is the documentation for the MedTel’s V2.0 API. The Help Center API documentation supplements it. Read the content of this page carefully, including the Restrictions and Responsibilities, to understand how to be a good API citizen.

Header

This is a JSON-only API. You must supply a Content-Type: application/json header on PUT and POST operations. You must set an Accept: application/json header on all requests. You may get a text/plain response in case of an error such as a bad request. You should treat this as an error you need to fix.

Authentication

ApiKeyAuth (API Key Authentication)

name: Authorization
in: header
demo authorization: a3afc0c8a929baf26fc9d3d58da9854c

Paths

Generate Consultation

PATH

https://api.medtel.in/api/consultation/

METHOD

Post

DESCRIPTION

Generate a consultation request based on the given data.

EXAMPLE


curl -X POST \
  https://thp.medtel.in/test/testapi
  -H 'authorization: your authorization key' \
  -F patient_name=Raj Srivastav \
  -F mobile=111100000 \
  -F age=30 \
  -F gender=Male \
  -F weight=65 \
  -F address=Banglore \
  -F chief_complain=Fever \
  -F bloodpressure=121/78 \
  -F pulse=74 \
  -F temprature=99.1 \
  -F fbs=101 \
  -F ppbs=135 \
  -F client_token=unique_client_token_id

RESPONSE

200 OK: successful operation

400 Forbidden: Access fobidden


Response Content-Types: application/json
Response Example (200 OK)

  {
    "code": 200,
    "status": "TRUE",
    "msg": "successfully inserted",
    "uniqueid": "medtel uniqueid"
  }
Response Example (400 Forbidden)

{
  "code": 400,
  "status": "FALSE",
  "message": "invalid request"
}

Get Consultation Data

PATH

Webhook URL

DESCRIPTION

User-defined HTTP callbacks where you can receive the consultation data from us. This way you can get real-time information as soon as it happens.

Response Example


(
    [request_details] => 
    	{
	    "uniqueid":"e9c2d7b5718dcd1e3d0b84b2b6568c24",
	    "client_uniqueid":"unique_client_token_id",
	    "patient_name":"Raj Srivastav",
	    "mobile":"111100000",
	    "address":"Bangalore",
	    "gender":"Female",
	    "age":"31",
	    "weight":"66",
	    "chief_complain":"Follow up case of sore throat with white patches around the throat.. (H\/O-Hypothyroidism)\t(TSH-5.92)",
	    "diagnosis":"Hypothyroidism ? Tonsillitis ?",
	    "medical_tests":"prescribed tests",
	    "prescription":"prescription url",
	    "consultant_doctor":"Naveen ",
	    "consultant_doctor_specialization":"General Practitioner",
	    "datetime":"2020-05-24 16:21:04",
	    "prescribed_medicines":[
		{
			"medicine_name":"Thyronorm (37.5 MCG)",
			"medicine_strength":"Thyroxine Sodium 37.5 MCG",
			"medicine_quantity":"Take 1 Tablet 45 minutes before breakfast.",
			"medicine_days":"30",
			"medicine_time":"Once Daily",
			"medicine_when":"After Food"
		}
	    ]
    	}
)

Get POC Test Data

PATH

Webhook URL

DESCRIPTION

User-defined HTTP callbacks where you can receive the test data from us. This way you can get real-time information as soon as it happens.

Response Example


(
    [request_details] => {
    	"uniqueid":"ecee20e12e2db28a5f58b2a997eaf1f5",
    	"name":"Raj Srivastav",
    	"mobile":"111100000",
    	"gender":"Male",
    	"age":"37",
    	"screening_date":"2020-08-16",
    	"screening_details":[
    		{
    		    "pocType":"SpO2",
    		    "pocResult":
			{
				"spo2":"98",
				"spo2_pulse":"76",
				"spo2_pi":"5"
			}
    		},
    		{
    		    "pocType":"Vitals_BP",
    		    "pocResult":
			{
				"bp":"101/75 mmHg",
				"pulse":"79"
			}
    		},
    		{
    		    "pocType":"Sync",
    		    "pocResult":
			{
				"glucose":"163",
				"glucoseCategory":"Random"
			}
    		},
    		{
    		    "pocType":"Spirometer",
    		    "pocResult":
			{
				"spi_fvc":"1.78",
				"spi_fev1":"1.78",
				"spi_fev6":"1.78",
				"spi_fev1_fvc":"100",
				"spi_fef_25_75":"8.13",
				"spi_pef":"536"
			}
    		},
    		{
    		    "pocType":"Thermometer",
    		    "pocResult":
			{
				"thermometer":"97.2",
				"thermometer_unit":"\u00b0F"
			}
    		},
    		{
    		    "pocType":"Hemoglobin",
    		    "pocResult":
			{
				"hemoglobin":"9.2"
			}
    		},
    		{
    		    "pocType":"Lipid_Profile",
    		    "pocResult":
			{
				"triglycerides":"1",
				"total_cholesterol":"2",
				"hdl_cholesterol":"3",
				"ldl":"4",
				"vldl":"5",
				"tc_hdl_ratio":"6"
			}
    		},
    		{
    		    "pocType":"Stethoscope",
    		    "pocResult":
			{
				"url":"https://medtel.io"
			}
    		},
    		{
    		    "pocType":"ECG",
    		    "pocResult":
			{
				"url":"https://medtel.io"
			}
    		}
    	]
    }
)