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 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 = bg
Формат
Определете дали искате форматът на отговора да бъде 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
За всяка заявка към тази услуга има два необходими параметъра:
- Кодова система
Идентифицирайте системата с проблемни кодове, която ще използвате.- За използване на 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, където може да се използва информацията за името / заглавието). 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 = Diabetes% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20uncontroll & 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 до% 20Pseudomonas% 20% 28разстройство% 29 & informationRecipient.languageCode.c = bg
Пациент със същата диагноза, но исканият формат е 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
За да изпратите заявка, включете тази информация:
- Кодова система
Определете вида на кода на лекарството, който изпращате. (Задължително за английски и испански)- За използване на RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- За използване на NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Код
Идентифицирайте действителния код, който се опитвате да потърсите. (Предпочитан за английски, задължителен за испански)
mainSearchCriteria.v.c = 637188 - Име на лекарството
Идентифицирайте името на лекарството с текстов низ. (По избор за английски, не се използва за испански)
mainSearchCriteria.v.dn = Chantix 0,5 MG орална таблетка
Незадължителни параметри
Заглавие на кодаКогато изпращате заявка за информация на английски език, можете да включите незадължителния параметър на името на лекарството. Това е подробно описано в горния раздел. mainSearchCriteria.v.dn = Chantix 0,5 MG орална таблетка
Вижте горния раздел за изходни параметри за подробности относно езика и изходните формати.
Описание на избрани атомни елементи (или 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 = bg
За да поискате информация от 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
Това са два необходими параметъра за всяка лабораторна тестова заявка към тази услуга:
- Кодова система
- Идентифицирайте, че използвате системата LOINC код. Употреба:
- mainSearchCriteria.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.dn = Factor% 20IX% 20assay & informationRecipient.languageCode.c = bg 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.language. = es
Политика за приемливо използване
За да се избегне претоварването на MedlinePlus сървърите, NLM изисква потребителите на MedlinePlus Connect да изпращат не повече от 100 заявки в минута на IP адрес. Заявките, които надвишават този лимит, няма да бъдат обслужвани и услугата няма да бъде възстановена за 300 секунди или докато процентът на заявките падне под лимита, което от двете настъпи по-късно. За да ограничите броя на заявките, които изпращате до Connect, NLM препоръчва кеширане на резултати за период от 12-24 часа.
Тази политика е въведена, за да гарантира, че услугата остава достъпна и достъпна за всички потребители. Ако имате конкретен случай на употреба, който изисква от вас да изпратите голям брой заявки до MedlinePlus Connect и по този начин да надвишите ограничението на скоростта на заявки, посочено в тази политика, моля, свържете се с нас. Персоналът на NLM ще оцени вашето искане и ще определи дали може да бъде предоставено изключение. Моля, прегледайте и документацията за XML файловете на MedlinePlus. Тези XML файлове съдържат пълни записи за здравни теми и могат да служат като алтернативен метод за достъп до данни на MedlinePlus.