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 адпаведным старонкам тэм здароўя, старонкам генетыкі або старонкам іншых інстытутаў NIH. Напрыклад, пацыенту з дыягназам МКБ-9-СМ з кодам 493.12 "Знешняя астма з абвастрэннем" можа быць прадастаўлена спасылка ў электроннай медыцынскай карце (EHR), якая вядзе на старонку MedlinePlus "Астма".

Па гэтай спасылцы адлюстроўваецца старонка з пустым полем пошуку. Для любога запыту да гэтага прыкладання неабходны два параметры:

1. Вызначце сістэму кода праблемы, якую вы будзеце выкарыстоўваць.
   

   Для выкарыстання па МКБ-10-СМ:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Для выкарыстання па МКБ-9-СМ:

   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 = be

Прыклады запытаў на коды праблем

Поўны запыт на цукровы дыябет з іншай некантралюемай комай тыпу 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 = Дыябет% 20mellitus% 20с% 20астатнімі% 20coma% 20type% 201% 20uncontroll & informationRecipient.languageCode.c = es

Пацыент з дыягназам "Пнеўманія з-за псевдомонады" з выкарыстаннем кода CT SNOMED 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchnriterіv.v. Пнеўманія% 20 да% 20 да% 20 псеўдаманады% 20% 28разлад% 29 & informationRecipient.languageCode.c = be

Запыт у свабоднай форме, без сістэмы кода або кода праблемы, будзе выкарыстоўваць пошукавую сістэму 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 = be

Прыклады запытаў на коды наркотыкаў

Ваш запыт на інфармацыю пра лекі павінен выглядаць наступным чынам.

Каб запытаць інфармацыю 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 = be

Каб запытаць інфармацыю з боку НДЦ для іспанамоўнага, ваш запыт павінен выглядаць так: 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 можа даць адказы на запыты лабараторных выпрабаванняў на англійскай або іспанскай мовах і верне спасылку на старонку вынікаў з лепшымі супадзеннямі з інфармацыі лабараторнага тэсту.

Для запытаў на інфармацыю аб лабараторных выпрабаваннях базавы 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 = be

Запыт у свабоднай форме, без сістэмы кода і лабараторнага кода, будзе выкарыстоўваць пошукавую сістэму 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 = be https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.langua. = 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. = эс

Палітыка прымальнага выкарыстання

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

Гэтая палітыка дзейнічае, каб гарантаваць, што паслуга застаецца даступнай і даступнай для ўсіх карыстальнікаў. Калі ў вас ёсць канкрэтны выпадак выкарыстання, які патрабуе ад вас вялікай колькасці запытаў у MedlinePlus Connect і, такім чынам, перавышэння абмежавання хуткасці запытаў, указанага ў гэтай палітыцы, звяжыцеся з намі. Персанал NLM ацэніць ваш запыт і вызначыць, ці можа быць прадастаўлена выключэнне. Таксама праглядзіце дакументацыю па файлах XML MedlinePlus. Гэтыя XML-файлы ўтрымліваюць поўныя запісы тэм пра здароўе і могуць служыць альтэрнатыўным спосабам доступу да дадзеных MedlinePlus.

Дадатковая інфармацыя