MedlinePlus Connect: Веб кызматы

Мазмун

• Веб кызматына сереп
• Output Parameters
• Диагностика (Проблема) коддору боюнча сурамдар
• Кошумча параметрлер
• Тандалган Атом элементтеринин (же JSON объектилеринин) Проблемалык Код Сурамдарына жооп катары сүрөттөлүшү
• Проблемалык коддорго суроо-талаптардын мисалдары
• Окшош кызматтар жана файлдар
• Баңги заттар жөнүндө маалымат алуу үчүн сурамдар
• Кошумча параметрлер
• Медикаменттердин сурамдарына жооп катары тандалган атом элементтеринин (же JSON объектилеринин) сүрөттөлүшү
• Баңгизаттардын кодун сурап кайрылуунун мисалдары
• Лабораториялык тестирлөө жөнүндө маалымат
• Кошумча параметрлер
• Тандалган Атом элементтеринин (же JSON объектилеринин) лабораториялык тестирлөө өтүнүчүнө жооп катары сүрөттөлүшү
• Лабораториялык сыноолорго суроо-талаптардын мисалдары
• Алгылыктуу колдонуу саясаты
• Кошумча маалымат

MedlinePlus Connect Веб тиркеме же Веб кызмат катары жеткиликтүү. Төмөндө сурамдарга жооп берген Веб кызматын ишке ашыруу үчүн техникалык маалыматтар келтирилген:

MedlinePlus Connect тарабынан кайтарылып берилген маалыматтарга шилтеме берип, көрсөтсөңүз болот. MedlinePlus баракчаларын өзүңүздүн сайтка көчүрө албайсыз. Эгер сиз MedlinePlus Connect Веб кызматынын маалыматтарын колдонгон болсоңуз, анда MedlinePlus.govдон алынган маалыматты көрсөтүңүз, бирок MedlinePlus логотиби колдонулбасын же башка жол менен MedlinePlus сиздин жеке өнүмүңүздү колдойт дегенди билдирет. Сураныч, кошумча жетекчилик үчүн NLMдин API барагын караңыз. Бул кызматтан тышкары MedlinePlus мазмунуна шилтеме берүү жөнүндө көбүрөөк маалымат алуу үчүн, шилтеме берүү боюнча көрсөтмөлөрүбүздү жана көрсөтмөлөрүбүздү караңыз.

Эгерде сиз MedlinePlus Connectти колдонууну чечсеңиз, анда электрондук почта тизмесине катталып, өнүгүүлөр менен таанышып, кесиптештериңиз менен пикир алмашыңыз. Сураныч, MedlinePlus Connect программасын колдонуп, биз менен байланышып, айтып бериңиз.

Веб кызматына сереп

Веб-сервис сурамдарынын параметрлери HL7 контекстти билүүчү билимдерди издөөгө (Infobutton) ылайык, билимдерди талап кылуучу URL негизделген. REST негизиндеги жооп HL7 контекстти билүүчү билимдерди издөө (Infobutton) сервисине багытталган архитектураны ишке ашыруу боюнча колдонмого шайкеш келет. Сурамдын натыйжасы Atom канал түрүндөгү XML, JSON же JSONP болушу мүмкүн.

Сурамдын түзүмү сиз кайсы код түрүн жөнөтүп жатканыңызды көрсөтөт. Бардык учурларда, Веб кызматтын URL дареги: https://connect.medlineplus.gov/service

MedlinePlus Connect HTTPS байланыштарын колдонот. HTTP сурамдары кабыл алынбайт жана HTTP колдонгон колдонмолор HTTPS жаңыртуусу керек.

Output Parameters

Бул параметрлер милдеттүү эмес. Эгер аларды калтырсаңыз, демейки жооп - XML ​​форматындагы англисче маалымат.

Тил
Жооптун англис же испан тилинде болушун каалаарыңызды аныктаңыз. MedlinePlus Connect эгерде көрсөтүлбөсө, анда англис тили деп эсептейт.

Эгер сиз көйгөй кодун издөөгө испан тилинде жооп берүүнү кааласаңыз, анда төмөнкүнү колдонуңуз: informationRecipient.languageCode.c = es
(= sp дагы кабыл алынган)

Англис тилин көрсөтүү үчүн төмөнкүнү колдонуңуз: informationRecipient.languageCode.c = en

Формат
Жооп форматы 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 барагынын аталышы
шилтеме		Дал келтирилген MedlinePlus ден-соолук темасынын бетине же GHR баракчасына URL
резюме		Ден-соолук темасы боюнча кыскача кыскача маалымат. Бул ден-соолукка байланыштуу башка темаларга шилтемелерди камтыйт, ошондой эле бардык форматтоо, анын ичинде ок жана абзац аралыктары. Жыйынтык 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контрольсуз & 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&main.ritCeria Пневмония% 20дүйнө% 20то% 20Псевдомонас% 20% 28бөлүм% 29 & informationRecipient.languageCode.c = ky

Ошол эле диагнозу бар, бирок талап кылынган форматтагы бейтап JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javcript&

Окшош кызматтар жана файлдар

Көйгөйлүү коддордон айырмаланып, текст сурамдарына жооп катары MedlinePlus ден-соолук темаларын алуу үчүн MedlinePlus Веб кызматын изилдеңиз. Ошондой эле, сизге XML форматындагы MedlinePlus ден-соолук темаларынын толук топтому керек болсо, анда биздин 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

   УДК колдонуу үчүн:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect ошондой эле англис тилиндеги дары-дармектер жөнүндө маалымат алуу үчүн сурамдар үчүн тексттик сапты кабыл ала алат, бирок сиз жогоруда келтирилген эки код системасынын бирин кошуп, дары жөнүндө маалымат издеп жатканыңызды көрсөтүшүңүз керек.
2. Код
   Издөөгө аракет кылып жаткан кодду аныктаңыз. (Англис тили, испан тили талап кылынат)
   mainSearchCriteria.v.c = 637188
3. Дары-дармектин аталышы
   Препараттын атын тексттик сап менен аныктаңыз. (Англисче милдеттүү эмес, испанча колдонулбайт)
   mainSearchCriteria.v.dn = Chantix 0.5 MG Оозеки Планшет

Кеминде сиз код системасын жана кодду, же код системасын жана препараттын аталышын аныкташыңыз керек. Англис тилиндеги сурамдар боюнча эң жакшы натыйжаларга жетүү үчүн үчөөнү тең жөнөтүңүз. Код тутумун жана испан тилиндеги сурамдар үчүн кодду жөнөтүңүз.

Кошумча параметрлер

Коддун аталышы

Англисче маалымат алуу үчүн сурам жөнөтүп жатып, дары-дармектин аталышынын кошумча параметрин киргизсеңиз болот. Бул жогорудагы бөлүмдө кеңири баяндалган. mainSearchCriteria.v.dn = Chantix 0.5 MG Оозеки Планшет

Тил жана чыгарылыш форматтары жөнүндө кеңири маалымат алуу үчүн, Output Parameters бөлүмүнүн жогорудагы бөлүмүн караңыз.

Медикаменттердин сурамдарына жооп катары тандалган атом элементтеринин (же JSON объектилеринин) сүрөттөлүшү

Элемент	Сүрөттөмө
аталышы	Дал келген MedlinePlus дары баракчасынын аталышы
шилтеме	Дал келген MedlinePlus дары баракчасынын URL дареги
автор	Дары-дармек боюнча маалыматтын булагы

Баңгизаттардын кодун сурап кайрылуунун мисалдары

Дары-дармектер боюнча маалымат сурамыңыз төмөнкүлөрдүн бирине окшош болушу керек.

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% 20Oral% 20Tablet & informationRecipient.languageCode.c = en

Испан спикери үчүн УДКдан маалымат сураш үчүн, сиздин сурамыңыз төмөнкүдөй болушу керек: 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.language = 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 фактордук анализ

Тил жана чыгарылыш форматтары жөнүндө кеңири маалымат алуу үчүн, Output Parameters бөлүмүнүн жогорудагы бөлүмүн караңыз.

Тандалган Атом элементтеринин (же JSON объектилеринин) лабораториялык тестирлөө өтүнүчүнө жооп катары сүрөттөлүшү

Элемент	Сүрөттөмө
аталышы	Дал келген MedlinePlus лабораториялык тест барагынын аталышы
шилтеме	Дал келген MedlinePlus лабораториялык тест баракчасынын URL дареги
резюме	Барактын мазмунунан үзүндү
автор	Лабораториялык тесттин мазмунунун булак атрибуциясы

Лабораториялык сыноолорго суроо-талаптардын мисалдары

Англис спикери үчүн маалымат алуу үчүн, сурамыңыз төмөнкүлөрдүн бирине окшош болушу мүмкүн: 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 = en https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecip. = 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&informationRecip. = es

Алгылыктуу колдонуу саясаты

MedlinePlus серверлерин ашыкча жүктөөдөн сактануу үчүн, NLM MedlinePlus Connect колдонуучуларынан IP дареги үчүн мүнөтүнө 100дөн ашык сурам жөнөтүүнү талап кылат. Ушул чектен ашып кеткен сурамдар тейленбейт жана тейлөө 300 секундага чейин же кийинчерээк келген сурам чеги лимиттин астына түшкөнгө чейин калыбына келтирилбейт. Connectке жиберген сурамдарыңыздын санын чектөө үчүн, NLM кэштөөнүн натыйжаларын 12-24 сааттык мөөнөткө сунуштайт.

Бул саясат кызматтын бардык колдонуучуларга жеткиликтүү жана жеткиликтүү болушун камсыз кылуу максатында колдонулат. Эгерде сизде MedlinePlus Connectке көп сандаган сурамдарды жөнөтүүнү талап кылган жана ушул саясатта көрсөтүлгөн суроо-талаптын чегинен ашып кетүүңүздү талап кылган белгилүү бир иш болсо, биз менен байланышыңыз. NLM кызматкерлери сиздин өтүнүчүңүздү баалап, өзгөчө кырдаал түзүлүшү мүмкүн экендигин аныкташат. Сураныч, MedlinePlus XML файлдарынын документтерин карап чыгыңыз. Бул XML файлдары ден-соолук темасынын толук жазууларын камтыйт жана MedlinePlus маалыматтарын алуунун кошумча ыкмасы катары кызмат кыла алат.

Кошумча маалымат