MedlinePlus Connect: веб-додаток

Зміст

• Огляд веб-додатків
• Запити на коди діагностики (проблеми)
• Необов’язкові параметри
• Приклади запитів на коди проблем
• Запити на інформацію про ліки
• Необов’язкові параметри
• Приклади запитів на коди наркотиків
• Запити на інформацію про лабораторні тести
• Необов’язкові параметри
• Приклади запитів на лабораторні тести
• Політика прийнятного використання
• Більше інформації

MedlinePlus Connect доступний як веб-додаток або веб-служба. Нижче наведено технічні деталі реалізації веб-програми, яка відповідає на запити на основі:

Якщо ви вирішили використовувати MedlinePlus Connect, підпишіться на список розсилки, щоб не відставати від розробок і обмінюватися думками зі своїми колегами. Скажіть нам, чи впроваджуєте Ви MedlinePlus Connect, зв’язавшись з нами. Ви можете зробити посилання та відобразити дані, надані MedlinePlus Connect. Для отримання додаткової інформації про те, як зробити посилання на вміст MedlinePlus поза межами цієї послуги, див. Наші вказівки та інструкції щодо встановлення посилань.

Огляд веб-додатків

API для веб-програми відповідає специфікації реалізації на основі запиту на знання HL7 з інформацією про контекст (Infobutton). Структура запиту вказує, який тип коду ви надсилаєте. У всіх випадках базовою URL-адресою веб-програми є: https://connect.medlineplus.gov/application

MedlinePlus Connect використовує з'єднання HTTPS. Запити HTTP не приймаються, і існуючі реалізації, що використовують HTTP, повинні оновитись до HTTPS.

Запити на коди діагностики (проблеми)

MedlinePlus Connect відповідає кодам ICD-10-CM, ICD-9-CM або SNOMED CT до відповідних сторінок тем MedlinePlus щодо охорони здоров’я, сторінок генетики або сторінок інших інститутів NIH. Наприклад, пацієнтові з діагнозом МКБ-9-СМ з кодом 493.12 «Зовнішня астма із загостренням» може бути представлено посилання в електронній медичній картці (EHR), що веде на сторінку MedlinePlus Asthma.

За цим посиланням відображається сторінка з порожнім вікном пошуку. Для будь-якого запиту до цієї програми є два обов’язкові параметри:

1. Визначте систему кодів проблем, яку ви будете використовувати.
   

   Для використання ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Для використання ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Для використання SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Визначте фактичний код, який ви намагаєтеся знайти:
   mainSearchCriteria.v.c = 250,33

Необов’язкові параметри

Визначте назву / заголовок коду проблеми. Відправка жодного коду не призведе до запиту до пошукової системи MedlinePlus. Якщо ви вкажете код і ім'я / заголовок коду, але MedlinePlus Connect не має результатів, на сторінці відповідей відобразиться поле пошуку MedlinePlus, попередньо заповнене іменем / заголовком. mainSearchCriteria.v.dn = Цукровий діабет з іншими комами типу 1 неконтрольовано

Визначте, чи хочете ви, щоб запит був англійською чи іспанською. MedlinePlus Connect вважатиме, що англійською мовою є мова, якщо вона не вказана.

Якщо ви хочете, щоб відповідь на пошук коду проблеми була іспанською, використовуйте: informationRecipient.languageCode.c = es
(= sp також прийнято)

Щоб вказати англійську мову, використовуйте наступне: informationRecipient.languageCode.c = uk

Приклади запитів на коди проблем

Повний запит на цукровий діабет з іншою неконтрольованою комою типу 1, код МКБ-9 250.33, для іспаномовного пацієнта міститиме таку URL-адресу: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Діабет% 20мелітус% 20з% 20іншими% 20кома% 20тип% 201% 20неконтрольований & informationRecipient.languageCode.c = es

Пацієнт з діагнозом "Пневмонія внаслідок псевдомонади" з використанням коду КН SNOMED 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchnritriv.v. Пневмонія% 20за% 20до% 20Псевдомонада% 20% 28розлад% 29 & informationRecipient.languageCode.c = uk

Запит у вільній формі без кодової системи чи коду проблеми використовуватиме пошукову систему MedlinePlus (лише англійською мовою): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Діабет

Запити на інформацію про ліки

MedlinePlus Connect забезпечує найкращу відповідність інформації про ліки при отриманні RXCUI. Це також забезпечує хороші результати при отриманні коду NDC. MedlinePlus Connect може надавати відповіді на запити коду ліків англійською або іспанською мовами та повертати посилання на сторінку результатів із найкращими збігами в інформації про ліки MedlinePlus.

Для запитів на інформацію про ліки англійською мовою, якщо ви не надсилаєте код NDC або RXCUI або якщо ми не знаходимо відповідності на основі коду, ми використовуємо текстовий рядок, який ви надсилаєте, для відображення найкращого відповідності інформації про ліки. На запити щодо іспанської інформації про ліки MedlinePlus Connect відповідає лише на NDC або RXCUI; він не використовує текстові рядки. Можна отримати відповідь англійською мовою, але жодної - іспанською.

На один запит на ліки може бути кілька відповідей. Не завжди може бути відповідність для кожного запиту. Якщо MedlinePlus Connect знаходить нульову відповідь на запит на ліки, програма відображає вікно пошуку для сайту MedlinePlus. Користувач може ввести назву препарату і, можливо, отримати хороший відгук.

Для запитів на інформацію про ліки базовою URL-адресою є: https://connect.medlineplus.gov/application

Запити на інформацію про ліки англійською та іспанською мовами мають різні вимоги. Щоб надіслати запит, включіть такі відомості:

1. Визначте тип коду ліків, який ви надсилаєте. (Обов’язково для англійської та іспанської)
   

   Для використання RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Для використання NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

2. Визначте фактичний код, який ви намагаєтеся знайти. (Переважно для англійської, обов’язково для іспанської)
   mainSearchCriteria.v.c = 637188
3. Визначте назву препарату за допомогою текстового рядка. (Необов’язково для англійської, не використовується для іспанської)
   mainSearchCriteria.v.dn = Chantix 0,5 мг оральна таблетка

Для запитів англійською мовою слід вказати як мінімум систему кодів та код, або систему кодів та назву препарату. Надішліть усіх трьох, щоб отримати найкращі результати для запитів англійською Для запитів іспанською мовою слід ідентифікувати систему кодів та код.

Необов’язкові параметри

Надсилаючи запит на інформацію англійською мовою, ви можете включити необов’язковий параметр назви препарату. Про це детально йдеться у наведеному вище розділі. Цей параметр не використовується для запитів на іспанській мові.

Визначте, чи хочете ви, щоб запит був англійською чи іспанською. MedlinePlus Connect вважатиме, що англійською мовою є мова, якщо вона не вказана.

Якщо ви хочете, щоб відповідь на пошук коду ліків була іспанською, використовуйте: informationRecipient.languageCode.c = es (= sp також прийнято)

Щоб вказати англійську мову, використовуйте наступне: informationRecipient.languageCode.c = uk

Приклади запитів на коди наркотиків

Ваш запит на інформацію про ліки повинен виглядати так:

Щоб запитувати інформацію за допомогою RXCUI, ваш запит повинен виглядати так: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=%20637188%20&mainSearchCriteria.v.dn = Chantix% 200,5% 20MG% 20Усно% 20Таблетка та інформаціяRecipient.languageCode.c = uk

Щоб запитати інформацію в NDC для іспаномовного, ваш запит повинен виглядати так: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.languageCode.c = es

Щоб надіслати текстовий рядок без коду ліків, ви повинні визначити свій запит як запит типу NDC, щоб MedlinePlus Connect знав, що ви шукаєте інформацію про ліки. Це працюватиме лише для англійської мови. Ваш запит може мати такий вигляд: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.v.dn=Chantix%200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.languageCode. = en

Запити на інформацію про лабораторні тести

MedlinePlus Connect забезпечує збіги з інформацією лабораторних досліджень при отриманні запиту LOINC. MedlinePlus Connect може надати відповіді на запити лабораторних тестів англійською або іспанською мовами та поверне посилання на сторінку результатів із найкращими збігами з інформації лабораторного тесту MedlinePlus.

Для запитів на інформацію про лабораторні тести базовою URL-адресою є: https://connect.medlineplus.gov/application

Це два обов’язкові параметри для будь-якого лабораторного тестового запиту до цієї програми:

1. Визначте, що ви використовуєте систему кодів LOINC.
   

   Для використання LOINC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect також приймає:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Визначте фактичний код, який ви намагаєтеся знайти.
   mainSearchCriteria.v.c = 3187-2

Необов’язкові параметри

Визначте назву / назву лабораторного тесту. Однак ця інформація не впливає на реакцію. mainSearchCriteria.v.dn = Аналіз фактора IX

Визначте, чи хочете ви, щоб запит був англійською чи іспанською. MedlinePlus Connect вважатиме, що англійською мовою є мова, якщо вона не вказана.

Якщо ви хочете, щоб відповідь на пошук коду проблеми була іспанською, використовуйте: informationRecipient.languageCode.c = es (= sp також прийнято)

Щоб вказати англійську мову, використовуйте наступне: informationRecipient.languageCode.c = uk

Запит у вільній формі без системи коду чи лабораторного коду використовуватиме пошукову систему MedlinePlus. Цей підхід є більш ефективним при діагнозах (див. Інформацію про код проблеми вище) замість текстових рядків лабораторного тесту. Ваш запит на інформацію про лабораторний тест повинен виглядати так:

Приклади запитів на лабораторні тести

Щоб запросити інформацію для англомовного, ваш запит може виглядати таким: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Factor% 20IX% 20assay & informationRecipient.languageCode.c = uk https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language. = en

Щоб запросити інформацію для іспаномовного, ваш запит може виглядати таким: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Factor% 20IX% 20assay & informationRecipient.languageCode.c = es https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.langua. = es

Політика прийнятного використання

Щоб уникнути перевантаження серверів MedlinePlus, NLM вимагає, щоб користувачі MedlinePlus Connect відправляли не більше 100 запитів на хвилину на IP-адресу. Запити, які перевищують цей ліміт, не будуть обслуговуватися, і обслуговування не буде відновлено протягом 300 секунд або до тих пір, поки рівень запиту не опуститься нижче межі, залежно від того, що настане пізніше. Щоб обмежити кількість запитів, які ви надсилаєте на Connect, NLM рекомендує результати кешування протягом 12-24 годин.

Ця політика діє, щоб гарантувати, що служба залишатиметься доступною та доступною для всіх користувачів. Якщо у вас є конкретний випадок використання, який вимагає надсилання великої кількості запитів до MedlinePlus Connect і, таким чином, перевищення обмеження кількості запитів, зазначеного в цій політиці, зв’яжіться з нами. Співробітники NLM оцінять ваш запит та визначать, чи може бути надано виняток. Також перегляньте документацію до файлів XML MedlinePlus. Ці файли XML містять повні записи тем здоров'я та можуть служити альтернативним методом доступу до даних MedlinePlus.

Більше інформації