enurse.ru API
https://api.enurse.ru
Общие положения
enurse.ru - Электронная сиделка, облачный сервис по массовому мониторингу состояния здоровья человека, основанный на программно-аппаратном решении, разработанном компаниями группы РТЛаб. Система построена на основе открытых стандартов и направлена на становление и дальнейшее развитие мобильной медицины и сетей медицинских вещей в России и мире. Сервис enurse.ru состоит из следующих географически разделенных компонент:
- Оборудование мониторинга пациента. Это оборудование отправляет биометрические данные пациента в облако enurse.ru. Оборудование взаимодействует с облаком посредством enurse.ru API.
- Облако enurse.ru принимает и обрабатывает данные мониторинга, а также сохраняет и анализируются их на предмет определения условий различных категорий событий. При совпадении условий, определяемых системой правил, генерируются те или иные события. Сохраненные мониторинговые данные и события доступны для внешних приложений или платформ посредством enurse.ru API.
- Внешнее приложение - это программное обеспечение, интегрированное с облаком enurse.ru посредством enurse.ru API. В качестве приложения может выступать внешняя платформа аналитики и визуализации данных, мобильное приложение, web-приложение, иное программное обеспечение.
Важная информация
В настоящее время сервис enurse.ru не имеет регистрационного удостоверения Росздравнадзора и может быть использован только для информационных (немедицинских) целей.
Показатели здоровья (метрики) пациента
Для удобства, показатели разбиваются на группы:
- Базовые
- Кардиологические
- Респираторные
- Сомнологические
- Постельного режима
Определены следующие базовые показатели здоровья человека
- Частота пульса в минуту (heart rate per minute). Имя метрики NOM_BCG_CARDIO.
- Частота дыхания в минуту (breath rate per minute). Имя метрики NOM_BCG_RESP.
- Индекс гемодинамической активности (circulatory dynamics index). Имя метрики NOM_BCG_CDI.
- Индекс двигательной активности (motor activity index). Имя метрики NOM_BCG_MOTION.
/metrics/basic
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
time | Время регистрации индикаторов. Если время не указано, вовзращаются последние зарегистриированные в системе значения индикаторов | 2016-02-28T16:41:41.090Z | datetime | false |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"time": 'Thu Nov 29 20:31:36 MSK 2016',
"metrics":
{
"NOM_BCG_CARDIO": 100,
"NOM_BCG_RESP": 70,
"NOM_BCG_CDI": 20,
"NOM_BCG_MOTION": 10
}
}
Определены следующие кардиологические показатели здоровья человека
- Частота пульса в минуту (heart rate per minute). Имя метрики NOM_BCG_CARDIO.
- Индекс гемодинамической активности (circulatory dynamics index). Имя метрики NOM_BCG_CDI.
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
time | Время регистрации показателей. Если время не указано, вовзращаются последние зарегистриированные в системе значения показателей | 2016-02-28T16:41:41.090Z | datetime | false |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"time": 'Thu Nov 29 20:31:36 MSK 2016',
"cardio-metrics":
{
"NOM_BCG_CARDIO": 100,
"NOM_BCG_CDI": 20
}
}
Определены следующие респираторные показатели здоровья человека
- Частота дыхания в минуту (breath rate per minute). Имя метрики NOM_BCG_RESP.
- Индекс двигательной активности (motor activity index). Имя метрики NOM_BCG_MOTION.
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
time | Время регистрации индикаторов. Если время не указано, вовзращаются последние зарегистриированные в системе значения индикаторов | 2016-02-28T16:41:41.090Z | datetime | false |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"time": 'Thu Nov 29 20:31:36 MSK 2016',
"resp-metrics":
{
"NOM_BCG_RESP": 100,
"NOM_BCG_MOTION": 100
}
}
Определены следующие сомнологические показатели здоровья пациента
- Частота пульса в минуту (heart rate per minute). Имя метрики NOM_BCG_CARDIO.
- Частота дыхания в минуту (breath rate per minute). Имя метрики NOM_BCG_RESP.
- Индекс гемодинамической активности (circulatory dynamics index). Имя метрики NOM_BCG_CDI.
- Индекс двигательной активности (motor activity index). Имя метрики NOM_BCG_MOTION.
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
time | Время регистрации индикаторов. Если время не указано, вовзращаются последние зарегистриированные в системе значения индикаторов | 2016-02-28T16:41:41.090Z | datetime | false |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"time": 'Thu Nov 29 20:31:36 MSK 2016',
"sleep-metrics":
{
"NOM_BCG_CARDIO": 100,
"NOM_BCG_RESP": 70,
"NOM_BCG_CDI": 20,
"NOM_BCG_MOTION": 10
}
}
Определены следующие показатели постельного режима человека
- Индекс двигательной активности (motor activity index). Имя метрики NOM_BCG_MOTION.
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
time | Время регистрации индикаторов. Если время не указано, вовзращаются последние зарегистриированные в системе значения индикаторов | 2016-02-28T16:41:41.090Z | datetime | false |
Ответ
Пример:
{
"uid": "SNR-MD737408184368862P0",
"time": 'Thu Nov 29 20:31:36 MSK 2016',
"bed-metrics":
{
"NOM_BCG_MOTION": 100
}
}
События мониторинга состояния человека
События мониторинга состояния человека объединяют в себе следующие группы событий:
- Поток всех событий
- Кардиологические события
- Респираторные события
- Сомнологические события
- События постельного режима
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
start | Начало периода выборки событий | 2016-02-28T16:41:41.090Z | datetime | true | |
stop | Конец периода выборки событий. Если параметр не указан, концом периода является текущее астраномическое время | 2016-02-28T16:41:41.090Z | datetime | true |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"events": [{
"name": "EVT_SLEEP_DROWSE",
"time": "Thu Nov 29 20:31:36 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 65,
"NOM_BCG_RESP": 18,
"NOM_BCG_CDI": 30,
"NOM_BCG_MOTION": 50
}
}, {
"name": "EVT_SLEEP_LIGHT",
"time": "Thu Nov 29 20:40:30 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 60,
"NOM_BCG_RESP": 16,
"NOM_BCG_CDI": 29,
"NOM_BCG_MOTION": 45
}
}, {
"name": "EVT_CARDIO_ARRYTHMIA",
"priority": "PRT_LOW",
"time": "Thu Nov 29 20:41:20 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 57,
"NOM_BCG_RESP": 30,
"NOM_BCG_CDI": 25,
"NOM_BCG_MOTION": 30
}
}, {
"name": "EVT_SLEEP_MIDDLE",
"time": "Thu Nov 29 20:51:25 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 55,
"NOM_BCG_RESP": 14,
"NOM_BCG_CDI": 23,
"NOM_BCG_MOTION": 35
}
}, {
"name": "EVT_CARDIO_ARRYTHMIA",
"priority": "PRT_LOW",
"time": "Thu Nov 29 20:55:50 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 57,
"NOM_BCG_RESP": 30,
"NOM_BCG_CDI": 25,
"NOM_BCG_MOTION": 30
}
}, {
"name": "EVT_SLEEP_DEEPLY",
"time": "Thu Nov 29 21:31:30 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 52,
"NOM_BCG_RESP": 12,
"NOM_BCG_CDI": 20,
"NOM_BCG_MOTION": 10
}
}, {
"name": "EVT_SLEEP_AWAKENING",
"time": "Thu Nov 29 21:55:10 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 61,
"NOM_BCG_RESP": 16,
"NOM_BCG_CDI": 31,
"NOM_BCG_MOTION": 150
}
}]
}Кардиологические события определяются на основе кардиологических показателей. Определены следующие кардиологические события:
- Частота пульса в «норме». Имя события EVT_CARDIO_NORM.
- Брадикардия. Имя события EVT_CARDIO_BRADY. Событие может принимать приоритеты «средний», «высокий» и «критический».
- Тахикардия. Имя события EVT_CARDIO_TACHY. Событие может принимать приоритеты «средний», «высокий» и «критический».
- Аритмия. Имя события – EVT_CARDIO_ARRYTHMIA. Событие может принимать приоритеты «средний», «высокий» и «критический».
- Остановка сердца. Имя события EVT_CARDIO_FAIL. Событие может принимать приоритеты «средний», «высокий» и «критический».
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
start | Начало периода выборки событий | 2016-02-28T16:41:41.090Z | datetime | true | |
stop | Конец периода выборки событий. Если параметр не указан, концом периода является текущее астраномическое время | 2016-02-28T16:41:41.090Z | datetime | true | |
filter | Уровень фильтрации на основе приоритетов событий. Допустимые значения - PRT_LOW - события не фильтруются (значение по умолчанию, указывать не обязательно) - PRT_MIDDLE - возвращаются события с приоритетом MIDDLE и выше - PRT_HIGH - возвращаются события с приоритетом HIGH и выше - PRT_CRITICAL - возвращаются события с приоритетом CRITICAL и выше | PRT_MIDDLE | string | true |
Ответ
Пример:
{
"events": [
{
"event_name": "EVT_CARDIO_NORM",
"uimd": "SNR-MD737408184368862P0",
"time": "1479843642000",
"priority": "PRT_MIDDLE",
"puls": 60,
"resp": 40,
"cdi": 10,
"motion": 10
},
{
"event_name": "EVT_CARDIO_BRADY",
"uimd": "SNR-MD737408184368862P0",
"time": "1479843642000",
"priority": "PRT_HIGH",
"puls": 60,
"resp": 40,
"cdi": 10,
"motion": 10
}
]
}
Респираторные события определяются на основе респираторных показателей. Определены следующие респираторные события:
- Частота дыхания в «норме». Имя события EVT_RESP_NORM.
- Гипервентиляция (тахиапноэ). Имя события EVT_RESP_TACHY. Событие может принимать приоритеты «средний», «высокий» и «критический».
- Гиповентиляция (брадиапноэ). Имя события EVT_RESP_BRADY. Событие может принимать приоритеты «средний», «высокий» и «критический».
- Остановка дыхания (апноэ). Имя события EVT_RESP_FAIL. Событие может принимать приоритеты «средний», «высокий» и «критический».
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
start | Начало периода выборки событий | 2016-02-28T16:41:41.090Z | datetime | true | |
stop | Конец периода выборки событий. Если параметр не указан, концом периода является текущее астраномическое время | 2016-02-28T16:41:41.090Z | datetime | true | |
filter | Уровень фильтрации на основе приоритетов событий. Допустимые значения - PRT_LOW - события не фильтруются (значение по умолчанию, указывать не обязательно) - PRT_MIDDLE - возвращаются события с приоритетом MIDDLE и выше - PRT_HIGH - возвращаются события с приоритетом HIGH и выше - PRT_CRITICAL - возвращаются события с приоритетом CRITICAL и выше | PRT_MIDDLE | string | true |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"events": [{
"name": "EVT_RESP_BRADY",
"priority": "PRT_MIDDLE",
"time": "Thu Nov 29 20:31:36 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 55,
"NOM_BCG_RESP": 13,
"NOM_BCG_CDI": 10,
"NOM_BCG_MOTION": 10
}
}, {
"name": "EVT_RESP_BRADY",
"priority": "PRT_HIGH",
"time": "Thu Nov 29 21:11:30 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 53,
"NOM_BCG_RESP": 9,
"NOM_BCG_CDI": 7,
"NOM_BCG_MOTION": 0
}
}, {
"name": "EVT_RESP_FAIL",
"priority": "PRT_MIDDLE",
"time": "Thu Nov 29 21:21:25 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 35,
"NOM_BCG_RESP": 0,
"NOM_BCG_CDI": 6,
"NOM_BCG_MOTION": 0
}
}]
}
Сомнологические события определяются на основе сомнологических показателей. Определены следующие сомнологические события:
- Бодрствование. Имя события EVT_SLEEP_AWAKENING. Это состояние, когда человек не спит, в том числе и не дремлет.
- Дремота. Имя события EVT_SLEEP_DROWSE. Это состояние дремоты, первая стадия поверхностного сна, достаточно короткая – ее продолжительность обычно составляет не более десяти минут. Входит в состав медленного сна, являясь его первой фазой (S1).
- Легкий сон. Имя события EVT_SLEEP_LIGHT. Вторая стадия поверхностного сна. Во время стадии легкого сна происходит отключение сознания с одновременным повышением слухового порога чувствительности. Это как раз то время, когда человека проще всего разбудить. Входит в состав медленного сна, являясь его второй фазой (S2).
- Средний сон. Имя события EVT_SLEEP_MIDDLE. Первая стадия глубокого сна, которая практически не сопровождается движением глазных яблок. Именно на этот период приходится более половины сновидений, которые обычно имеют спокойный, нейтральный сюжет и редко запоминаются, при этом разбудить спящего может быть очень непросто. Также именно в этом периоде может проявиться сомнамбулизм у людей с предрасположенностью к этому состоянию. Входит в состав медленного сна, являясь его третьей фазой (S3).
- Глубокий сон. Имя события EVT_SLEEP_DEEPLY. Вторая стадия глубокого сна. Это стадия самого глубокого, крепкого сна, которая практически не сопровождается движением глазных яблок. Характеризуется наиболее глубоким сном. Считается наиболее важной, так как в это время мозг получает самый полноценный отдых и восстанавливает свою работоспособность. В этой фазе сна человека сложно разбудить. Случаи разговора во сне или лунатизма происходят как раз в это фазе. Входит в состав медленного сна, являясь его четвертой фазой (S4).
- Быстрый сон. Имя события EVT_SLEEP_REM. Это REM-сон (от англ. Rapid Eye Movements - "Быстрые Движения Глаз") или быстрый сон, сменяет медленный сон (стадии поверхностного и глубокого сна).
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
start | Начало периода выборки событий | 2016-02-28T16:41:41.090Z | datetime | true | |
stop | Конец периода выборки событий. Если параметр не указан, концом периода является текущее астраномическое время | 2016-02-28T16:41:41.090Z | datetime | true |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"events": [{
"name": "EVT_SLEEP_DROWSE",
"time": "Thu Nov 29 20:31:36 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 65,
"NOM_BCG_RESP": 18,
"NOM_BCG_CDI": 30,
"NOM_BCG_MOTION": 50
}
}, {
"name": "EVT_SLEEP_LIGHT",
"time": "Thu Nov 29 20:40:30 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 60,
"NOM_BCG_RESP": 16,
"NOM_BCG_CDI": 29,
"NOM_BCG_MOTION": 45
}
}, {
"name": "EVT_SLEEP_MIDDLE",
"time": "Thu Nov 29 20:51:25 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 55,
"NOM_BCG_RESP": 14,
"NOM_BCG_CDI": 23,
"NOM_BCG_MOTION": 35
}
}, {
"name": "EVT_SLEEP_DEEPLY",
"time": "Thu Nov 29 21:31:30 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 52,
"NOM_BCG_RESP": 12,
"NOM_BCG_CDI": 20,
"NOM_BCG_MOTION": 10
}
}, {
"name": "EVT_SLEEP_AWAKENING",
"time": "Thu Nov 29 21:55:10 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 61,
"NOM_BCG_RESP": 16,
"NOM_BCG_CDI": 31,
"NOM_BCG_MOTION": 150
}
}]
}События постельного режима определяются на основе индикаторов постельного режима. Определены следующие события постельного режима:
- Пациент опустился на кровать. Имя события EVT_BED_LOAD.
- Пациент принял на кровати лежачее положение. Имя события EVT_BED_LYING.
- Пациент встал из лежачего положения, но находится на кровати. Имя события EVT_BED_SITTING.
- Пациент покинул кровать. Имя события EVT_BED_EMPTY.
- Судороги. Имя события EVT_BED_MUSCLE_ARTIFACT. Интенсивность судорог определяется по показателю двигательной активности.
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
start | Начало периода выборки событий | 2016-02-28T16:41:41.090Z | datetime | true | |
stop | Конец периода выборки событий. Если параметр не указан, концом периода является текущее астраномическое время | 2016-02-28T16:41:41.090Z | datetime | true |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"events": [{
"name": "EVT_BED_LOAD",
"time": "Thu Nov 29 20:31:36 MSK 2016",
"metrics": {
"NOM_BCG_MOTION": 1550
}
}, {
"name": "EVT_BED_LYING",
"time": "Thu Nov 29 20:31:45 MSK 2016",
"metrics": {
"NOM_BCG_MOTION": 450
}
}, {
"name": "EVT_BED_SITTING",
"time": "Thu Nov 29 20:31:45 MSK 2016",
"metrics": {
"NOM_BCG_MOTION": 560
}
}, {
"name": "EVT_BED_LYING",
"time": "Thu Nov 29 20:32:33 MSK 2016",
"metrics": {
"NOM_BCG_MOTION": 470
}
}, {
"name": "EVT_BED_MUSCLE_ARTIFACT",
"time": "Thu Nov 29 23:33:15 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 58,
"NOM_BCG_RESP": 22,
"NOM_BCG_CDI": 35,
"NOM_BCG_MOTION": 350
}
}, {
"name": "EVT_BED_MUSCLE_ARTIFACT",
"time": "Thu Nov 29 01:13:45 MSK 2016",
"metrics": {
"NOM_BCG_CARDIO": 55,
"NOM_BCG_RESP": 21,
"NOM_BCG_CDI": 30,
"NOM_BCG_MOTION": 250
}
}, {
"name": "EVT_BED_EMPTY",
"time": "Thu Nov 29 21:31:30 MSK 2016",
"metrics": {
"NOM_BCG_MOTION": 10
}
}]
}Tренды
Тренды - графики показателей здоровья за определенный отрезок времени. В массивах возвращается не более 1000 значений координаты Y. Координата X равняется i-му отсчету от начала массива
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
period | Период выборки - 3, 6, 12, 24 часа. Значение по умолчанию - 3 | 3 | integer | false | |
start | Начало отрезка времени. Если параметр не задан, возвращаются тренды за последние 3 часа. Если заданы параметр start и не задан period - интересуют тренды за время от start плюс 3 часа. Если заданы оба параметра start и period - интересуют тренды указанный диапазон времени. Если запрошены тренды за 24 часа, а с момента start прошло 18 часов, возвращаются тренды за 18 часов. | 2016-02-28T16:41:41.090Z | datetime | false |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"start": "Thu Nov 29 19:31:36 MSK 2016",
"stop": "Thu Nov 29 23:11:36 MSK 2016",
"trends": {
"NOM_BCG_CARDIO": [65,65,66,66,66,65,65,66,65,...., 66,65,74,74,75,75],
"NOM_BCG_RESP": [20,20,20,20,20,21,21,21,21,21,21,......, 23,23,23],
"NOM_BCG_CDI": [5,6,5,6,5,6,5,6,6,7,7,6,7,......, 7,7,7,8],
"NOM_BCG_MOTION": [150,151,151,151,155,170,......., 2000,2050,1900,10,10,10,11]
}
}
Фильтры
Фильтры - регистрируемые запросы на уведомленея о произошедших событиях
Фильтр создается на получение информации о событиях в соответствии с условиями фильтра
Параметры запроса
| Параметр | Имя параметра | Пример | Тип параметра | Обязательный? | |
|---|---|---|---|---|---|
id | Идентификатор устройства | SNR-MD737408184368862P0 | string | true | |
events | Тип событий. Принимает значения EVT_CARDIO, EVT_RESP, EVT_SLEEP, EVT_BED. Если группа событий не указана, происходит уведомление о любых событиях. | EVT_CARDIO | string | false | |
priority | Приоритет событий. Принимает значения PRT_MIDDLE, PRT_HIGH, PRT_CRITICAL. Если приоритет событий не указан, происходит уведомление о событиях любого приоритета. | PRT_MIDDLE | string | false |
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"filter-status": "created",
"filter-id": "FLTR-MD737408184368862P0-001"
}
Статус пациента
Статус пациента - интегральный индикатор состояния здоровья человека
Статус пациента может принимать следующие значения
- STAT_UNKNOWN. Этот статус означает, что в текущий момент времени устройство не регистрирует состояние здоровья человека
- STAT_GREEN. Этот статус означает, что жизни человека ничего не угрожает
- STAT_YELLOW. Этот статус означает, что жизни человека ничего не угрожает, однако состояние его здоровья ухудшилось
- STAT_RED. Этот статус означает, что состояние здоровья человека существенно ухудшилось, возникла угроза его жизни
- STAT_BROWN. Этот статус означает, что состояние здоровья человека тяжелое, возникла существенная угроза его жизни
Ответ
Пример:
{
"uimd": "SNR-MD737408184368862P0",
"time": "Thu Nov 29 20:31:36 MSK 2016",
"patient-status": "STAT_GREEN"
}