Описание и рекомендации по использованию сервиса
Сервис является интеграционным и встраивается в состав медицинской информационной системы (МИС), метод доступа — REST API, формат данных — JSON.
Для проверки наличия противопоказаний необходимо направить POST-запрос на адрес:
В теле запроса требуется указать информацию о проверяемых препаратах (в виде пары Действующее вещество и Лекарственная форма), состоянии пациента (в виде набора витальных параметров), интересующих конкретно противопоказаниях, нозологиях или классе противопоказаний. Формат предоставления - JSON, структура входных данных приведена ниже:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
{
/* Медикаментозное назначение (список ДВ+ЛФ) – обязательный для заполнения блок */
"medication": [
{
"activeSubstanceId": 179, /* Гидрохлоротиазид */
"dosageFormId": 4 /* таблетки */
},
{
"activeSubstanceId": 138, /* Амлодипин */
"dosageFormId": null /* лек. форма не указана */
},
{
"activeSubstanceId": 217, /* Валсартан */
"dosageFormId": 23 /* таблетки, покрытые пленочной оболочкой */
},
{
"activeSubstanceId": 678, /* Бисопролол */
"dosageFormId": 23 /* таблетки, покрытые пленочной оболочкой */
},
{
"activeSubstanceId": 2230, /* Аторвастатин */
"dosageFormId": null /* лек. форма не указана */
},
{
"activeSubstanceId": 3524, /* Фебуксостат */
"dosageFormId": 23 /* таблетки, покрытые пленочной оболочкой */
}
],
/* Состояние пациента - опционально */
"patient":
{
/*
Витальные параметры:
paramId – идентификатор витального параметра из справочника;
selectorId – указатель на базовый словарь (например, ДВ, ФГ, АТХ и пр.);
value – значение параметра (если указан selectorId, то в value передаётся значение из базового словаря);
unitId – идентификатор единицы измерения из справочника
*/
"parameters":
[
/* Баллы по шкале Чайлд-Пью: 10 баллов */
{"paramId": 1, "value": "10", "unitId": 6},
/* Возраст: 6 лет */
{"paramId": 2, "selectorId": null, "value": 6, "unitId": 3},
/* Клиренс креатинина: 17 мл/мин */
{"paramId": 3, "value": 17, "unitId": 4},
/* Систолическое артериальное давление: 75 мм рт. ст. */
{"paramId": 5, "value": 75, "unitId": 2},
/* Анамнез */
{"paramId": 11, "value": "Заболевания печени"},
/* Репродуктивный статус: Репродуктивный возраст (2) */
{"paramId": 12, "selectorId": 98126, "value": 2, "unitId": null}
]
},
/* Витальные характеристики (нормализованные термины из ИМП) - опционально */
"terms": [
{"termId" : 17}, /* аритмия */
{"termId" : 18}, /* артериальная гипотензия */
{"termId" : 51}, /* васкулит */
{"termId" : 88}, /* гиперчувствительность */
{"termId" : 144}, /* импотенция */
{"termId" : 145}, /* инсульт */
{"termId" : 148}, /* инфаркт миокарда */
{"termId" : 215}, /* нарушение функции почек */
{"termId" : 252}, /* острая почечная недостаточность */
{"termId" : 263}, /* ощущение сердцебиения */
{"termId" : 312}, /* почечная недостаточность */
{"termId" : 364}, /* стенокардия */
{"termId" : 374} /* тахикардия */
],
/*
Нозологии (разделы МКБ) – опционально:
318 - I49 Другие нарушения сердечного ритма
1869 - N19 Почечная недостаточность неуточненная
5954 - I95.2 Гипотензия, вызванная лекарственными средствами
*/
"mkbIds": [318,1869,5954],
/* Класс противопоказания – опционально */
"classes": [1,2] /* 1 - противопоказано, 2 - с осторожностью */
}
-
medication – блок лекарственного назначения (список лекарственных препаратов):
- activeSubstanceId – код (id) действующего вещества из справочника dict_active_substances;
- dosageFormId – код (id) лекарственной формы из справочника dict_dosage_form. Может принимать значение null или отсутствовать - в этом случае проверяются все лекарственные формы.
-
patient – состояние пациента:
- parameters – перечень витальных параметров, характеризующих состояние пациента:
- paramId – код (id) витального параметра из соответствующего справочника;
- selectorId – код (id) базового словаря (например, справочник ДВ, ФГ, АТХ и пр.); может принимать значение null или отсутствовать;
- value – значение параметра (если указан selectorId, то в value передаётся значение/код/идентификатор записи из базового словаря);
- unitId – код (id) единицы измерения из соответствующего справочника; может принимать значение null или отсутствовать – в этом случае будет применена единица измерения по умолчанию.
Получить справочник витальных параметров можно при помощи метода /api/check_cise/parameters.
- parameters – перечень витальных параметров, характеризующих состояние пациента:
-
terms – массив витальных характеристик (нормализованных терминов), встречающихся в поле Противопоказания инструкций по медицинскому применению:
- termId – код (id) витальной характеристики из справочника нормализованных терминов ИМП.
Получить справочник витальных характеристик можно при помощи метода /api/check_cise/terms.
- mkbIds – список нозологий (разделов МКБ), представленный идентификаторами из соответствующего классификатора.
-
classes – класс противопоказания, в общем случае - массив. Допустимые значения:
- 1 – противопоказано;
- 2 – с осторожностью.
Секция medication является обязательной для заполнения и передачи в запросе. Параметры patient/parameters, terms, mkbIds, classes - опциональные: в случае передачи витальных параметров в блоке patient/parameters поиск противопоказаний будет осуществлён только по указанным параметрам; в случае указания terms или mkbIds искомая информация о противопоказаниях будет определяться во множестве терминов из массива terms, объединённого с терминами, имеющими отношение к нозологиям из списка mkbIds; указав classes, можно отфильтровать данные по степени противопоказания.
Ответ системы возвращается в формате JSON и содержит поля, описанные ниже.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
/* Массив препаратов, для которых обнаружены противопоказания */
[
{
/* ДВ (ИД, название) */
"as_id": 138,
"as_name_rus": "Амлодипин",
/* Лек. форма (ИД, название) */
"dosage_form_id": 4,
"dosage_form_full_name": "таблетки",
/* Группировка по классам противопоказаний */
"classes": [
{
/* Класс противопоказания (ИД, название) */
"class_id": 1,
"class_name": "Противопоказано",
/* Список противопоказаний */
"contraindications": [
{
/* Инструкция (ИД, название) */
"source_id": 108041,
"source_name": "Амлодипин+ЛП-004926+28.01.2022+",
/* Обобщённый/нормализованный термин (ИД, название) */
"common_term_id": null,
"common_term_name": null,
/* Термин из ИМП (ИД, название) */
"instr_term_id": 2611,
"instr_term_name": "Возраст до 18 лет",
/* Перечень нозологий, к которым относится нормализованный термин */
"mkb": [
{
/* Нозология/раздел МКБ (ИД, название) */
"mkb_id": null,
"mkb_name": null
}
]
},
{
/* Инструкция (ИД, название) */
"source_id": 108041,
"source_name": "Амлодипин+ЛП-004926+28.01.2022+",
/* Обобщённый/нормализованный термин (ИД, название) */
"common_term_id": 18,
"common_term_name": "артериальная гипотензия",
/* Термин из ИМП (ИД, название) */
"instr_term_id": 2638,
"instr_term_name": "тяжелая артериальная гипотензия (систолическое артериальное давление менее 90 мм рт. ст.)",
/* Перечень нозологий, к которым относится нормализованный термин */
"mkb": [
{
/* Нозология/раздел МКБ (ИД, название) */
"mkb_id": 1032,
"mkb_name": "I95 Гипотензия"
}
]
}
]
},
...
]
},
...
]
Сервис выдает ответ о найденных противопоказаниях на основании инструкции по медицинскому применению на оригинальное торговое название препарата, содержащего действующее вещество.
- as_id – код (id) действующего вещества из справочника dict_active_substances, переданного на проверку (integer);
- as_name_rus – название действующего вещества из справочника dict_active_substances (string);
- dosage_form_id – код (id) лекарственной формы из справочника dict_dosage_form (integer);
- dosage_form_full_name – название лекарственной формы из справочника dict_dosage_form (string);
- classes – группировка по классу противопоказаний (степени риска):
- class_id – код класса (integer);
- class_name – название класса, степень риска (string);
- contraindications – массив противопоказаний:
- source_id – код (id) инструкции (integer);
- source_name – название/обозначение инструкции (string);
- common_term_id – код (id) нормализованного/обобщенного термина (integer);
- common_term_name – нормализованный/обобщенный термин (string);
- instr_term_id – код (id) термина из инструкции по медицинскому применению (integer);
- instr_term_name – термин из инструкции по медицинскому применению (string);
- mkb – массив нозологий, связанных с нормализованным термином:
- mkb_id – код (id) нозологии (integer);
- mkb_name – раздел МКБ/нозология (string);
- comment – примечание/комментарий (string).
Заявка на демоверсию
Заполните и отправьте заявку на демоверсию. Наш менеджер свяжется с вами в ближайшее время.
Частые вопросы
Не нашли ответа на свой вопрос? Напишите нам.
-
Можно ли получить тестовый доступ к сервисам?
Да, обратитесь к своему персональному менеджеру или заполните заявку на сайте. -
Обязателен ли выход в интернет на рабочем месте в ЛПУ?
Для работы с данными РЛС® достаточно периодически обновлять сервер внутренней информационной системы через доверенный шлюз. Доступ в интернет с каждого рабочего места не нужен. -
Можно ли приобрести фрагменты базы данных или сервисов, если мне нужен ограниченный набор данных?
Используя сервисы РЛС®, пользователь может подписываться на те фрагменты данных, которые нужны. -
Система пользователя будет зависима от работы облачного сервиса?
Нет, не будет. Пользователь скачивает данные в свою систему, в дальнейшем обращаясь к сервисам только за обновлениями. -
Как происходит обмен данными?
После оплаты вы получаете полный доступ к базе данных. Заходите на наш сервер и скачиваете базу (выбранные поля из анкеты), она будет храниться у вас в системе. Далее вы будете обращаться на наш облачный сервис только за обновлениями. -
Как часто обновляется кэш РЛС® Авроры?
Для любых наборов данных (кроме массивов Номенклатуры и Описаний) новые кэши в полном объеме создаются каждый день, поэтому запрашивать справочники dict_... без параметров можно ежедневно. Номенклатурный массив слишком большой, для того чтобы перестраивать его полностью каждый день. Таким образом, полный массив выкачивается раз в месяц запросом без параметров, а изменения — по удобному графику с параметром OnDate. -
Осуществляется ли техподдержка клиентов?
Да, техподдержка оказывается всем клиентам РЛС® и клиентам партнеров РЛС® с понедельника по пятницу с 9.00 до 17.00 по московскому времени. -
Как связаться с техподдержкой?
Если возникли вопросы, напишите на почту sales@rls-aurora.ru.
-
Как вступить в партнерскую программу?
Напишите нам на почту sales@rls-aurora.ru. -
Кто может стать партнером?
Юридические лица, подписавшие договор с РЛС®.
