MedlinePlus Connect: Веб-қызмет

Мазмұны

• Веб-қызметке шолу
• Шығару параметрлері
• Диагностикаға арналған кодтар (проблемалық)
• Қосымша параметрлер
• Проблемалық код сұраныстарына жауап ретінде таңдалған атом элементтерін (немесе 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 контекстті білетін білімді іздеу (инфобутно) сервиске бағытталған архитектураны енгізу бойынша нұсқаулыққа сәйкес келеді. Сұраудың нәтижесі Atom арнасының форматындағы XML, 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 = kz

Пішім
Жауап пішімі 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&mainvritCeria Пневмония% 20 күнтізбелік% 20-дан% 20 псевдомонас% 20% 28 бұзылу% 29 & informationRecipient.languageCode.c = kz

Дәл осындай диагнозы бар, бірақ сұралған формат JSONP пациенті: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javcript&jascript

Байланысты қызметтер мен файлдар

Мәтіндік сұрауларға жауап ретінде 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

Сұрау жіберу үшін келесі ақпаратты қосыңыз:

1. Код жүйесі
   Сіз жіберетін дәрі кодының түрін анықтаңыз. (Ағылшын және испан тілдеріне қажет)
   

   RXCUI пайдалану үшін:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   NDC пайдалану үшін:

   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 ауызша таблетка

Тіл мен шығыс форматтары туралы толық мәлімет алу үшін жоғарыдағы шығыс параметрлері бөлімін қараңыз.

Дәрілік сұраныстарға жауап ретінде таңдалған атом элементтерін (немесе 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 = kz

Испан спикері үшін 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.language = kk

Зертханалық тест туралы ақпаратқа сұраныстар

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 факторды талдау

Тіл мен шығыс форматтары туралы толық мәлімет алу үшін жоғарыдағы шығыс параметрлері бөлімін қараңыз.

Зертханалық тест тапсырыстарына жауап ретінде таңдалған атом элементтерінің (немесе 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 = kz https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecip. = kk

Испан спикері үшін ақпарат сұрау үшін, сіздің сұрауыңыз келесілердің біріне ұқсас болуы мүмкін: 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 деректеріне қол жеткізудің балама әдісі бола алады.

Көбірек ақпарат