MedlinePlus Connect: веб-служба

Зміст

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

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

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

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

Огляд веб-служби

Параметри запитів веб-служб відповідають Посібнику із впровадження на основі URL-адреси запиту на знання HL7 з інформаційним контекстом (Infobutton). Відповідь, заснована на REST, відповідає Посібнику з реалізації службово-орієнтованої архітектури HL7, орієнтованої на контекст (Infobutton). Результатом запиту може бути XML у форматі подачі Atom, JSON або JSONP.

Структура запиту вказує, який тип коду ви надсилаєте. У всіх випадках базовою URL-адресою веб-служби є: https://connect.medlineplus.gov/service

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

Вихідні параметри

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

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

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

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

Формат
Визначте, чи хочете ви, щоб формат відповіді був XML, JSON або JSONP. За замовчуванням використовується XML.

Щоб замовити JSON, використовуйте:

knowledgeResponseType = application / json

Для JSONP використовуйте:

knowledgeResponseType = application / javascript & callback = CallbackFunction, де CallbackFunction - це ім'я, якому ви надаєте функцію зворотного дзвінка.

Для відповіді в XML використовуйте:

knowledgeResponseType = text / xml або залиште параметр knowledgeResponseType поза запитом.

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

Для коду проблеми MedlinePlus Connect повертає посилання та інформацію зі сторінок тем охорони здоров’я MedlinePlus, генетичних сторінок або сторінок інших Інститутів NIH.

MedlinePlus Connect поверне наступне:

Не завжди може збігатися кожен код. У цих випадках MedlinePlus Connect поверне нульову відповідь.

Базова URL-адреса сервісу: https://connect.medlineplus.gov/service

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

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 Connect, де може використовуватися інформація про ім'я / заголовок). mainSearchCriteria.v.dn = Цукровий діабет з неконтрольованою іншою комою 1 типу. Детальніше про мову та вихідні формати див. у наведеному вище розділі Параметри виводу.

Опис вибраних атомних елементів (або об’єктів JSON) у відповідь на запити коду проблеми

Стихія	Вузол класу	Опис
заголовок		Заголовок відповідної сторінки теми здоров’я MedlinePlus або сторінки GHR
посилання		URL-адреса для відповідної сторінки теми здоров’я MedlinePlus або сторінки GHR
резюме		Повний підсумок теми охорони здоров’я. Це включає вбудовані посилання на інші відповідні теми охорони здоров’я та всі форматування, включаючи маркери та інтервали між абзацами. Короткий зміст наведено у форматі HTML. Для сторінок GHR надається перший розділ повної сторінки.
резюме		Синоніми до теми. Вони називаються "Також називаються" на сторінці теми здоров'я. Не всі теми містять терміни "Також називають".
резюме		Підтвердження атрибуції тексту резюме, якщо більшість резюме надійшло від іншого федерального відомства. Не всі зведення мають атрибуцію. Текст без атрибутів є оригінальним для MedlinePlus.
резюме		Вибрані посилання, пов'язані з темою. Сюди входять назва сторінки, URL-адреса та пов’язана організація (якщо застосовно). Посилання відформатовані в маркованому списку. Не всі теми мають ці посилання. Кількість посилань може коливатися від нуля до десятків.

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

Повний запит на цукровий діабет з іншою неконтрольованою комою 1 типу, код МКБ-9 250.33, для іспаномовного пацієнта містив би таку URL-адресу: https://connect.medlineplus.gov/service?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

Пацієнт з однаковим діагнозом, але запитуваний формат - JSON, а мова - англійська: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

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

Пацієнт з таким самим діагнозом, але запитуваний формат - JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackCallback

Супутні послуги та файли

Щоб отримувати теми здоров'я MedlinePlus у відповідь на текстові запити, на відміну від кодів проблем, досліджуйте веб-службу MedlinePlus. Крім того, якщо вам потрібен повний набір тем здоров’я MedlinePlus у форматі XML, перегляньте нашу сторінку файлів XML.

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

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

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

Веб-служба MedlinePlus Connect поверне наступне:

На один запит на ліки може бути кілька відповідей. Не завжди може бути відповідність для кожного запиту. У цих випадках MedlinePlus Connect поверне нульову відповідь.

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

Щоб надіслати запит, включіть такі відомості:

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

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

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

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

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

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

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

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

Заголовок коду

Надсилаючи запит на інформацію англійською мовою, ви можете включити необов’язковий параметр назви препарату. Про це детально йдеться у наведеному вище розділі. mainSearchCriteria.v.dn = Chantix 0,5 мг оральна таблетка

Детальніше про мову та формати виводу див. У наведеному вище розділі „Параметри виводу”.

Опис вибраних атомних елементів (або об’єктів JSON) у відповіді на запити на ліки

Стихія	Опис
заголовок	Заголовок для відповідної сторінки ліків MedlinePlus
посилання	URL-адреса відповідної сторінки ліків MedlinePlus
автор	Атрибуція джерела для інформації про ліки

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

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

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

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

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

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

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

Веб-служба MedlinePlus Connect поверне наступне:

Не завжди може збігатися кожен код. У цих випадках MedlinePlus Connect поверне нульову відповідь.

Базова URL-адреса сервісу: https://connect.medlineplus.gov/service

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

1. Кодова система
   

   Визначте, що ви використовуєте систему кодів 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

Детальніше про мову та формати виводу див. У наведеному вище розділі „Параметри виводу”.

Опис вибраних атомних елементів (або об’єктів JSON) у відповіді на запити лабораторного тесту

Стихія	Опис
заголовок	Назва відповідної лабораторної тестової сторінки MedlinePlus
посилання	URL-адреса для відповідної лабораторної тестової сторінки MedlinePlus
резюме	Фрагмент із вмісту сторінки
автор	Атрибуція джерела для змісту лабораторного тесту

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

Щоб запросити інформацію для англійської мови, ваш запит може виглядати так: https://connect.medlineplus.gov/service?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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageuage. = en

Щоб запросити інформацію для іспаномовного, ваш запит може виглядати таким: https://connect.medlineplus.gov/service?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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageuage. = es

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

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

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

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