МедлинеПлус Цоннецт: Веб услуга
Садржај
- Преглед веб услуга
- Излазни параметри
- Захтеви за кодове дијагнозе (проблема)
- Опционални параметри
- Опис изабраних атомских елемената (или ЈСОН објеката) у одговору на захтеве за кодом проблема
- Примери захтева за шифре проблема
- Повезане услуге и датотеке
- Захтеви за информације о лековима
- Опционални параметри
- Опис изабраних атомских елемената (или ЈСОН објеката) у одговору на захтеве за лековима
- Примери захтева за кодове лекова
- Захтеви за информације о лабораторијским тестовима
- Опционални параметри
- Опис изабраних атомских елемената (или ЈСОН објеката) у одговору на захтеве за лабораторијским тестом
- Примери захтева за лабораторијске тестове
- Политика прихватљиве употребе
- Више информација
МедлинеПлус Цоннецт је доступан као веб апликација или веб услуга. Испод су технички детаљи за примену веб услуге која одговара на захтеве засноване на:
Можете се повезати и приказати податке које враћа МедлинеПлус Цоннецт. Не можете копирати странице МедлинеПлус на своју веб локацију. Ако користите податке из МедлинеПлус Цоннецт веб услуге, наведите да су информације са МедлинеПлус.гов, али не користите МедлинеПлус логотип или на други начин подразумевајте да МедлинеПлус одобрава ваш одређени производ. Молимо погледајте НЛМ-ову АПИ страницу за даља упутства. За више информација о начину повезивања са садржајем МедлинеПлус изван ове услуге, погледајте наше смернице и упутства за повезивање.
Ако се одлучите за МедлинеПлус Цоннецт, пријавите се на списак е-адреса да бисте пратили развој и размењивали идеје са колегама. Реците нам да ли имплементирате МедлинеПлус Цоннецт тако што ћете нас контактирати.
Преглед веб услуга
Параметри за захтеве за веб услугом су у складу са ХЛ7 Водичем за примену на основу захтева за познавање контекста (Инфобуттон) Захтева за знање. Одговор заснован на РЕСТ-у прилагођен је ХЛ7 Водичу за примену архитектуре оријентисаном према услузи о контексту (Инфобуттон). Излаз захтева може бити КСМЛ у формату Атом феед-а, ЈСОН или ЈСОНП.
Структура захтева означава коју врсту кода шаљете. У свим случајевима, основни УРЛ веб услуге је: хттпс://цоннецт.медлинеплус.гов/сервице
МедлинеПлус Цоннецт користи ХТТПС везе. ХТТП захтеви неће бити прихваћени и постојеће примене које користе ХТТП треба да се ажурирају на ХТТПС.
Излазни параметри
Ови параметри нису обавезни. Ако их изоставите, подразумевани одговор су информације на енглеском у КСМЛ формату.
Језик
Утврдите да ли желите да одговор буде на енглеском или шпанском језику. МедлинеПлус Цоннецт ће претпоставити да је енглески језик језик ако није наведен.
Ако желите да одговор на претрагу кода проблема буде на шпанском, користите: информатионРеципиент.лангуагеЦоде.ц = ес
(= прихвата се и сп)
Да бисте одредили енглески, користите следеће: информатионРеципиент.лангуагеЦоде.ц = ен
Формат
Утврдите да ли желите да формат одговора буде КСМЛ, ЈСОН или ЈСОНП. Подразумевани је КСМЛ.
- Да бисте затражили ЈСОН, користите:
- кновледгеРеспонсеТипе = апплицатион / јсон
- За ЈСОНП користите:
- кновледгеРеспонсеТипе = апплицатион / јавасцрипт & цаллбацк = ЦаллбацкФунцтион где је ЦаллбацкФунцтион име које дајете функцију повратног позива.
- За одговор у КСМЛ-у користите:
- кновледгеРеспонсеТипе = тект / кмл или оставите параметар кновледгеРеспонсеТипе ван захтева.
Захтеви за кодове дијагнозе (проблема)
За код проблема, МедлинеПлус Цоннецт ће вратити везе и информације са страница са темама о здрављу МедлинеПлус, страница генетике или страница других института НИХ.
МедлинеПлус Цоннецт ће вратити следеће:
Не мора увек да се подудара сваки код. У тим случајевима, МедлинеПлус Цоннецт ће вратити нулл одговор.
Основни УРЛ услуге је: хттпс://цоннецт.медлинеплус.гов/сервице
Постоје два обавезна параметра за било који упит ове услуге:
- Цоде Систем
Идентификујте систем шифре проблема који ћете користити.- За употребу ИЦД-10-ЦМ:
- маинСеарцхЦритериа.в.цс = 2.16.840.1.113883.6.90
- За употребу ИЦД-9-ЦМ:
- маинСеарцхЦритериа.в.цс = 2.16.840.1.113883.6.103
- За употребу СНОМЕД ЦТ:
- маинСеарцхЦритериа.в.цс = 2.16.840.1.113883.6.96
- Код
Утврдите стварни код који покушавате да потражите:
маинСеарцхЦритериа.в.ц = 250.33
Опционални параметри
Наслов кода
Такође можете да идентификујете име / наслов шифре проблема. Међутим, ове информације не утичу на одговор (за разлику од МедлинеПлус Цоннецт веб апликације у којој се могу користити подаци о имену / наслову). маинСеарцхЦритериа.в.дн = Дијабетес мелитус са другом неконтролисаном комом типа 1 Погледајте горњи одељак о излазним параметрима за детаље о језику и излазним форматима.
Опис изабраних атомских елемената (или ЈСОН објеката) у одговору на захтеве за кодом проблема
Елемент | Чвор класе | Опис |
---|---|---|
наслов | Наслов подударне странице са здравственом темом МедлинеПлус или ГХР странице | |
линк | УРЛ за подударну страницу теме здравља МедлинеПлус или ГХР страницу | |
резиме | Комплетан резиме за здравствену тему. То укључује уграђене везе до других релевантних здравствених тема и све форматирање, укључујући набрајање и размаке између пасуса. Резиме је у ХТМЛ-у. За ГХР странице обезбеђен је први одељак целе странице. | |
резиме | Синоними за тему. Они се на страници са здравственим темама називају „Такође се називају“. Нису све теме изразе „Такође се називају“. | |
резиме | Потврда о приписивању за сажети текст, ако је главнина сажетка била из друге савезне агенције. Немају сви резимеи атрибуцију. Текст без атрибута је оригиналан за МедлинеПлус. | |
резиме | Одабрани линкови повезани са темом. То укључује назив странице, УРЛ адресу и повезану организацију (ако је применљиво). Везе су форматиране на листи са графичким ознакама. Немају све теме ове везе. Број веза може се кретати од нула до десетина. |
Примери захтева за шифре проблема
Потпуни захтев за дијабетес мелитус са неком неконтролисаном комом типа 1, ИЦД-9 код 250.33, за пацијента који говори шпански имао би следећу УРЛ адресу: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16 .840.1.113883.6.103 & маинСеарцхЦритериа.вц = 250.33 & маинСеарцхЦритериа.в.дн = Дијабетес% 20мелитус% 20д% 20кома% 20тип% 201% 20неконтролисано & информатионРеципиент.лангуагеЦоде.ц = ес
Пацијент са истом дијагнозом, али тражени формат је ЈСОН, а језик је енглески: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.103&маинСеарцхЦритериа.вц=250.33&кновледгеРеспонсеТипе=апплицатион / јсон
Пацијент коме је дијагностикована „пнеумонија због псеудомонасе“ помоћу СНОМЕД ЦТ кода 41381004: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.96&маинСеарцхЦритериа.вц=41381004&маинСеарцхЦритериа.в.д. Пнеумонија% 20дуе% 20то% 20Псеудомонас% 20% 28дисордер% 29 & информатионРеципиент.лангуагеЦоде.ц = ср
Пацијент са истом дијагнозом, али тражени формат је ЈСОНП: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.96&маинСеарцхЦритериа.в.ц=41381004&кновледгеРеспонсеТипе=апплицатион/јавасцрипт&цаллбацк=ЦаллбацкЦаллбацкЦаллбацк
Повезане услуге и датотеке
Да бисте примали теме о здрављу МедлинеПлус као одговор на текстуалне захтеве, за разлику од кодова проблема, истражите МедлинеПлус веб услугу. Такође, ако вам је потребан читав скуп здравствених тема МедлинеПлус у КСМЛ формату, погледајте нашу страницу КСМЛ датотека.
Захтеви за информације о лековима
МедлинеПлус Цоннецт пружа најбоље информације о лековима које се подударају када примате РКСЦУИ. Такође пружа добре резултате приликом пријема НДЦ кода. МедлинеПлус Цоннецт може да пружи одговоре на енглеском или шпанском језику.
За захтеве за информације о лековима на енглеском језику, ако не пошаљете НДЦ или РКСЦУИ или ако на основу кода не пронађемо подударање, апликација ће користити текстуални низ који ћете послати за приказ најбољег подударања информација о лековима. На захтеве за шпанским информацијама о лековима, МедлинеПлус Цоннецт одговара само НДЦ-има или РКСЦУИ-има и не користи текстуалне низове. Одговор је могућ на енглеском, али нема одговора на шпанском.
МедлинеПлус Цоннецт веб услуга ће вратити следеће:
На један захтев за лек може бити више одговора. Не може увек да се подудара сваки захтев. У тим случајевима МедлинеПлус Цоннецт ће вратити нулл одговор.
За захтеве за информацијама о лековима, основни УРЛ је: хттпс://цоннецт.медлинеплус.гов/сервице
Да бисте послали захтев, додајте ове податке:
- Цоде Систем
Утврдите врсту кода за лек који шаљете. (Обавезно за енглески и шпански)- За употребу РКСЦУИ:
- маинСеарцхЦритериа.в.цс = 2.16.840.1.113883.6.88
- За НДЦ употребу:
- маинСеарцхЦритериа.в.цс = 2.16.840.1.113883.6.69
- Код
Утврдите стварни код који покушавате да потражите. (Преферира се за енглески, обавезно за шпански)
маинСеарцхЦритериа.в.ц = 637188 - Име лека
Идентификујте назив лека помоћу текстуалног низа. (Необвезно за енглески, не користи се за шпански)
маинСеарцхЦритериа.в.дн = Цхантик 0,5 мг орална таблета
Опционални параметри
Наслов кодаКада шаљете захтев за информације на енглеском језику, можете да укључите опционални параметар назива лека. Ово је детаљно описано у горњем одељку. маинСеарцхЦритериа.в.дн = Цхантик 0,5 мг орална таблета
Погледајте горњи одељак о излазним параметрима за детаље о језику и излазним форматима.
Опис изабраних атомских елемената (или ЈСОН објеката) у одговору на захтеве за лековима
Елемент | Опис |
---|---|
наслов | Наслов за подударну страницу лекова МедлинеПлус |
линк | УРЛ одговарајуће странице лекова МедлинеПлус |
аутор | Извор атрибута за информације о лековима |
Примери захтева за кодове лекова
Ваш захтев за информацијама о лековима треба да изгледа овако:
Да бисте затражили информације од РКСЦУИ-а, ваш захтев треба да изгледа овако: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.88&маинСеарцхЦритериа.вц=637188&маинСеарцхЦритериа.в.дн=Цхантик% 200,5% 20 мг% 20 усмено% 20 таблета и информацијеРеципиент.лангуагеЦоде.ц = ср
Да бисте затражили информације од НДЦ-а за говорника шпанског, ваш захтев треба да изгледа овако: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.69&маинСеарцхЦритериа.вц=00310-0751- 39 & информатионРеципиент.лангуагеЦоде.ц = ес
Да бисте послали текстуални низ без кода за лек, морате свој упит идентификовати као захтев типа НДЦ, тако да МедлинеПлус Цоннецт зна да тражите информације о лековима. Ово ће радити само за захтеве на енглеском. Ваш захтев би могао изгледати овако: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.69&маинСеарцхЦритериа.в.дн=Цхантик%200.5%20МГ%20Орал%20Таблет&информатионРеципиент.лангуагеЦоде.ц = ен
Захтеви за информације о лабораторијским тестовима
МедлинеПлус Цоннецт пружа подударање са информацијама о лабораторијским тестовима када прима ЛОИНЦ захтев. Услуга може пружити одговор на енглеском или шпанском језику.
МедлинеПлус Цоннецт веб услуга ће вратити следеће:
Не мора увек да се подудара сваки код. У тим случајевима МедлинеПлус Цоннецт ће вратити нулл одговор.
Основни УРЛ услуге је: хттпс://цоннецт.медлинеплус.гов/сервице
Ово су два потребна параметра за било који лабораторијски тестни упит ове услуге:
- Цоде Систем
- Утврдите да користите систем ЛОИНЦ кодова. Употреба:
- маинСеарцхЦритериа.в.цс = 2.16.840.1.113883.6.1
- МедлинеПлус Цоннецт такође прихвата:
- маинСеарцхЦритериа.в.цс = 2.16.840.1.113883.11.79
- Код
идентификујте стварни код који покушавате да потражите:
маинСеарцхЦритериа.в.ц = 3187-2
Опционални параметри
Наслов кодаТакође можете да идентификујете назив лабораторијског теста. Међутим, ове информације не утичу на одговор. маинСеарцхЦритериа.в.дн = Анализа фактора ИКС
Погледајте горњи одељак о излазним параметрима за детаље о језику и излазним форматима.
Опис изабраних атомских елемената (или ЈСОН објеката) у одговору на захтеве за лабораторијским тестом
Елемент | Опис |
---|---|
наслов | Наслов подударне странице лабораторијског теста МедлинеПлус |
линк | УРЛ за одговарајућу лабораторијску тест страницу МедлинеПлус |
резиме | Исјечак из садржаја странице |
аутор | Изворна атрибуција за садржај лабораторијског теста |
Примери захтева за лабораторијске тестове
Да бисте затражили информације за говорнике енглеског језика, ваш захтев може изгледати као један од следећих: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.1&маинСеарцхЦритериа.вц=3187-2&маинСеарцхЦритериа. в.дн = Фацтор% 20ИКС% 20ассаи & информатионРеципиент.лангуагеЦоде.ц = ен хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.1&маинСеарцхЦритериа.вц=3187-2&информатионРеципиент.лангуагеуаге. = ен
Да бисте затражили информације за говорника шпанског, ваш захтев може изгледати као један од следећих: хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.1&маинСеарцхЦритериа.вц=3187-2&маинСеарцхЦритериа. в.дн = Фацтор% 20ИКС% 20ассаи & информатионРеципиент.лангуагеЦоде.ц = ес хттпс://цоннецт.медлинеплус.гов/сервице?маинСеарцхЦритериа.в.цс=2.16.840.1.113883.6.1&маинСеарцхЦритериа.вц=3187-2&информатионРеципиент.лангуагеуаге. = ес
Политика прихватљиве употребе
Да би се избегло преоптерећење МедлинеПлус сервера, НЛМ захтева да корисници МедлинеПлус Цоннецт шаљу не више од 100 захтева у минути по ИП адреси. Захтеви који премашују ово ограничење неће се сервисирати и услуга се неће вратити 300 секунди или док стопа захтева не падне испод ограничења, у зависности од тога шта касније наступи. Да би ограничио број захтева које шаљете на Цоннецт, НЛМ препоручује резултате кеширања у периоду од 12-24 сата.
Ова политика се примењује како би се осигурало да услуга остане доступна и доступна свим корисницима. Ако имате одређени случај коришћења који захтева да пошаљете велики број захтева МедлинеПлус Цоннецт-у и тако премашите ограничење стопе захтева описано у овој политици, контактирајте нас. Особље НЛМ ће проценити ваш захтев и утврдити да ли се може одобрити изузетак. Такође прегледајте документацију за МедлинеПлус КСМЛ датотеке. Ове КСМЛ датотеке садрже комплетне записе о здравственим темама и могу послужити као алтернативни метод приступа МедлинеПлус подацима.