Developer Guide
Try out our integration platform here.
The documentation on this page will show you how the Telli Health device data is transmitted to your platform.
All readings received by Telli Health are sent in near realtime by HTTPS POST to the POST URL in your profile.
All data packets are backed up in a Telli Health Secure Database in the event of system outages.
Upon purchase of your order, you should expect an email that will contain the Device ID and Serial number to match the device to a user on your platform.
Please note that an authentication token can be requested to be added to all headers.
In the headers it will read
x-api-key: <token>
Please contact support to enable authentications for your connection.
Defining Data Patterns
SpO2
deviceId – This is the deviceID of the device and will be provided to you on the side of the box and in an Excel file from Telli Health.
readingType – This is the device type for SpO2. It will always come as SpO2.
time – This is the time when the reading was taken.
data – Data transmitted.
spo2 – Blood Oxygen readings will range from 000 to 099.
pulse – Pulse readings will range from 000 to 200.
Sample Payload.
{
“deviceId”: “24ba8bd7-92e1-4b53-9304-32f4f04e6ad6”,
“readingType”: “SpO2”,
“time”: “1617084106540”,
“data”: {
“spo2”: 75,
“pulse”: 61
}
}
Blood Pressure
deviceId – This is the deviceID of the device and will be provided to you on the side of the box and in an Excel file from Telli Health.
readingType – This is the device type for BloodPressure. It will always come as Blood Pressure.
time – This is the time when the reading was taken.
systolic – User’s Systolic reading.
diastolic – User’s Diastolic reading
pulse – User’s Pulse reading.
arrhythmia – Will display 1 if an irregular heartbeat is detected, or 0 if not detected.
Sample Payload.
{
“deviceId”: “f9ac99cc-6578-45e2-9612-76ca8c2a7fce”,
“readingType”: “BloodPressure”,
“time”: “1617084106540”,
“data”: {
“systolic”: 90,
“diastolic”: 91,
“pulse”: 69,
“arrhythmia”: 1
}
}
Blood Glucose
deviceId – This is the ID of the device and will be provided to you on the side of the box and in an Excel file from Telli Health.
readingType – This is the device type for BloodGlucose. It will always come as BloodGlucose.
time – This is the time when the reading was taken.
data – Data transmitted.
glucose – User’s glucose level in mg/dl.
diastolic – User’s Diastolic reading
readingPeriod – This will display before or after based on user’s input for meals.
Sample Payload.
{
“deviceId”: “5fbf33aa-ba27-4527-8785-9259d08a55a4”,
“readingType”: “BloodGlucose”,
“time”: “1617084106540”,
“data”: {
“glucose”: 56,
“readingPeriod”: “before”
}
}
Weight Scale
Sample Payload
{ “deviceId”: “1234589”,
“readingType”: “Weight”,
“time”: “1621279157447”,
“data”:{
“weight”: 931,
“unit”: “lbs”
}
}
Thermometer
Sample Payload
{ “deviceId”: “1234589”,
“readingType”: “Temperature”,
“time”: “1629269150331”,
“data”:{
“temperature”: 67.6,
“unit”: “F”
}
}
Connections
Telli Health’s data gateway will send your data to the URL you specify when ordering your device or devices. Note: It is best practice to have a different slug per device. You only need to update your URL on first purchase of your device.
E.g.,
https://medicaldevice.example.com/spo2
As Telli Health’s listener receives readings, we will HTTPS POST the payload to the URL you requested in your account’s set up for that device. Telli Health’s POST will come from multiple Amazon East IP addresses.
Integration Code Samples
The Telli Health integration code can segment the content of the data stream into key-value pairs. This creates data in the tables that can be used by queries. We can specify the pattern to be identified and the names of the properties to develop.
Lambda Code Example
If at any time you would like to change your URL, please send an email to support@tellihealth.com
If you would like to request playback of your data, please send an email to support@tellihealth.com
If you would like an export of your data in CSV, please send an email to support@tellihealth.com
If you would like integration support, Telli Health can provide developers. Please email support@tellihealth.com for more information. Our developer rate is $200/hr.
