MedlinePlus Connect: Веб-услуга
Содржина
- Преглед на веб-услуги
- Излезни параметри
- Барања за кодови за дијагноза (проблем)
- Факултативни параметри
- Опис на избрани елементи на атом (или JSON објекти) како одговор на барањата за кодот на проблемот
- Примери на барања за кодови на проблеми
- Поврзани услуги и датотеки
- Барања за информации за лекови
- Факултативни параметри
- Опис на избрани елементи на атом (или JSON објекти) како одговор на барањата за лекови
- Примери на барања за кодови на лекови
- Барања за информации за лабораториски тестови
- Факултативни параметри
- Опис на избрани елементи на атом (или JSON објекти) како одговор на барањата за лабораториски тест
- Примери на барања за лабораториски тестови
- Политика за прифатлива употреба
- Повеќе информации
MedlinePlus Connect е достапен како веб-апликација или веб-услуга. Подолу се дадени техничките детали за спроведување на веб-услугата, која одговара на барањата засновани на:
Добредојдени сте да ги поврзете и прикажете податоците вратени од MedlinePlus Connect. Вие не можете да копирате страници на MedlinePlus на вашата страница. Ако користите податоци од веб-услугата Поврзете се на MedlinePlus, наведете дека информациите се од MedlinePlus.gov, но не користете го логото на MedlinePlus или на друг начин имплицирајте дека MedlinePlus го поддржува вашиот конкретен производ. Погледнете ја страницата API на НЛМ за понатамошно водство. За повеќе информации за тоа како да се поврзете со содржината на MedlinePlus надвор од оваа услуга, видете ги нашите упатства и упатства за поврзување.
Ако одлучите да користите MedlinePlus Connect, пријавете се на списокот за е-пошта за да бидете во тек со развојот и разменете идеи со вашите колеги. Ве молиме кажете ни дали ја имплементирате MedlinePlus Connect со тоа што контактирате со нас
Преглед на веб-услуги
Параметрите за барањата на веб-услугите се усогласени со Водичот за имплементација засновано врз барање на знаење за барање на знаење HL7 Контекст-знаење за пребарување на знаење (инфо копче). Одговорот базиран на РЕСТ е во согласност со Водичот за имплементација на архитектурата ориентирана кон услугата HL7 Контекст-свесно знаење за пребарување (инфо копче) Излезот на барањето може да биде XML во формат на Atom feed, 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 = en
Формат
Идентификувајте дали сакате форматот на одговор да биде XML, JSON или JSONP. XML е стандардно.
- За да побарате JSON, користете:
- знаењеResponseType = апликација / json
- За JSONP, користете:
- знаењеResponseType = апликација / javascript & повратен повик = Функција на повратен повик каде што CallbackFunction е име што ја давате на функцијата повратен повик.
- За одговор во XML, користете:
- знаењеResponseType = текст / xml или оставете го параметарот знаењеResponseType надвор од барањето.
Барања за кодови за дијагноза (проблем)
За код на проблем, MedlinePlus Connect ќе врати врски и информации од страниците за здравствена тема на MedlinePlus, страници за генетика или страници од други институти за NIH.
MedlinePlus Connect ќе го врати следново:
Можеби не секогаш има натпревар за секој код. Во тие случаи, MedlinePlus Connect ќе врати ништовен одговор.
Основната URL-адреса на услугата е: https://connect.medlineplus.gov/service
Постојат два потребни параметри за секое барање до оваа услуга:
- Систем за кодови
Идентификувајте го системот за кодови на проблеми што ќе го користите.- За употреба на 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
- Код
Идентификувајте го вистинскиот код што се обидувате да го побарате:
mainSearchCriteria.v.c = 250,33
Факултативни параметри
Наслов на кодот
Може да го идентификувате и името / насловот на кодот на проблемот. Сепак, оваа информација не влијае на одговорот (за разлика од MedlinePlus Connect Web апликацијата каде што може да се користат информациите за името / насловот). mainSearchCriteria.v.dn = Дијабетес мелитус со друга кома тип 1 неконтролиран Погледнете го горниот дел за Излезни параметри за детали за форматите на јазикот и излезот.
Опис на избрани елементи на атом (или JSON објекти) како одговор на барањата за кодот на проблемот
Елемент | Јазол на класа | Опис |
---|---|---|
Наслов | Наслов на соодветната страница за здравствена тема на MedlinePlus или страницата за GHR | |
врска | URL за соодветната страница на здравствената тема на MedlinePlus или страницата за GHR | |
резиме | Целосното резиме за здравствената тема. Ова вклучува вградени врски до други релевантни здравствени теми и сите форматирање, вклучувајќи куршуми и проред на пасуси. Резимето е во HTML. За страниците со GHR е даден првиот дел од целата страница. | |
резиме | Синоними за темата. Овие се наведени како "Исто така наречени" на страницата за здравствена тема. Не сите теми имаат поими „Исто така наречени“. | |
резиме | Признание за изворот за резимето, ако мнозинството од резимето е од друга федерална агенција. Не сите резимеа имаат атрибуција. Ненапишениот текст е оригинален за MedlinePlus. | |
резиме | Избрани врски поврзани со темата. Ова ги вклучува името на страницата, URL-то и поврзаната организација (кога е применливо). Врските се форматирани во список со натписи. Не сите теми ги имаат овие врски. Бројот на врски може да се движи од нула до десетици. |
Примери на барања за кодови на проблеми
Комплетното барање за дијабетес мелитус со друга неконтролирано кома тип 1, код ICD-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неконтролиран & информацииRecipient.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 / sonон
Пациент со дијагностицирана „Пневмонија поради Псевдомонас“ со употреба на кодот СНОМЕД КТ 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=4138100n&main Пневмонија% 20 доспевање% 20 до% 20 Псевдомонас% 20% 28 нарушување% 29 & информацииRecipient.languageCode.c = mk
Пациент со иста дијагноза, но бараниот формат е JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004& KnowledgeResponseType=application&jack/application/java
Поврзани услуги и датотеки
За да добивате здравствени теми на 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
За да испратите барање, вклучете ги овие информации:
- Систем за кодови
Идентификувајте го видот на кодот за лекови што го испраќате. (Задолжително за англиски и шпански јазик)- За употреба на RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- За употреба со НДЦ:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Код
Идентификувајте го вистинскиот код што се обидувате да го побарате. (Се претпочита за англиски, задолжително за шпански)
mainSearchCriteria.v.c = 637188 - Име на лекови
Идентификувајте го името на лекот со текстуална низа. (По избор за англиски, не се користи за шпански)
mainSearchCriteria.v.dn = Усна таблета Шантикс 0,5 МГ
Факултативни параметри
Наслов на кодотКога испраќате барање за информации на англиски јазик, може да го вклучите опционалниот параметар за името на лекот. Ова е детално во горниот дел. mainSearchCriteria.v.dn = Усна таблета Шантикс 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.ti.dn= 200,5% 20MG% 20Орален% 20 Таблет и информацииRecipient.languageCode.c = en
За да побарате информации од НДЦ за говорник на шпански јазик, вашето барање треба да изгледа вака: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & информацииRecipient.languageCode.c = es
За да испратите текстуална низа без код за лекови, мора да го идентификувате вашето барање како барање од типот NDC, така што MedlinePlus Connect знае дека барате информации за лекови. Ова ќе работи само за англиски барања. Вашето барање би можело да биде вака: = mk
Барања за информации за лабораториски тестови
MedlinePlus Connect обезбедува совпаѓања со информации за лабораториски тестови кога добивате барање за LOINC. Услугата може да обезбеди одговор на англиски или шпански јазик.
Веб-услугата MedlinePlus Connect ќе го врати следново:
Можеби не секогаш има натпревар за секој код. Во тие случаи, MedlinePlus Connect ќе врати ништовен одговор.
Основната URL-адреса на услугата е: https://connect.medlineplus.gov/service
Овие се два потребни параметри за кое било барање за лабораториски тест до оваа услуга:
- Систем за кодови
- Идентификувајте дека користите систем за шифрирање LOINC. Користете:
- главни критериуми за пребарување.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect исто така ќе прифати:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Код
идентификувајте го вистинскиот код што се обидувате да го побарате:
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. = mk
За да побарате информација за шпански говорник, вашето барање може да изгледа како едно од следниве: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v. = ес
Политика за прифатлива употреба
Со цел да се избегне преоптоварување на серверите MedlinePlus, НЛМ бара корисниците на MedlinePlus Connect да испраќаат не повеќе од 100 барања во минута по IP адреса. Барањата што ја надминуваат оваа граница нема да бидат сервисирани и услугата нема да биде вратена 300 секунди или додека стапката на барање не падне под границата, кое и да е подоцна. За да го ограничите бројот на барања што ги испраќате до Поврзете се, НЛМ препорачува да ги спасите резултатите за период од 12-24 часа.
Оваа политика е воспоставена за да се осигура дека услугата останува достапна и достапна за сите корисници. Ако имате специфичен случај за употреба што бара да испратите голем број барања до MedlinePlus Connect и со тоа да го надминете ограничувањето за стапка на барање, наведено во оваа политика, контактирајте не. Персоналот на НЛМ ќе го оцени вашето барање и ќе утврди дали може да се даде исклучок. Исто така, прегледајте ја документацијата за датотеките MedlinePlus XML. Овие XML-датотеки содржат целосна евиденција на здравствени теми и можат да послужат како алтернативен метод за пристап до податоците на MedlinePlus.