„MedlinePlus Connect“: žiniatinklio paslauga
Turinys
- Žiniatinklio paslaugos apžvalga
- Išvesties parametrai
- Prašymai nustatyti diagnozės (problemos) kodus
- Neprivalomi parametrai
- Pasirinktų „Atom“ elementų (arba JSON objektų) aprašymas atsakant į problemos kodo užklausas
- Užklausų dėl problemų kodų pavyzdžiai
- Susijusios paslaugos ir bylos
- Prašymai pateikti informacijos apie vaistus
- Neprivalomi parametrai
- Pasirinktų atominių elementų (arba JSON objektų) aprašymas atsakant į vaistų užklausas
- Prašymų pateikti narkotikų kodus pavyzdžiai
- Prašymai pateikti informaciją apie laboratorinius tyrimus
- Neprivalomi parametrai
- Pasirinktų atomo elementų (arba JSON objektų) aprašymas atsakant į laboratorinių bandymų užklausas
- Prašymų atlikti laboratorinius tyrimus pavyzdžiai
- Priimtino naudojimo politika
- Daugiau informacijos
„MedlinePlus Connect“ galima įsigyti kaip žiniatinklio programą arba žiniatinklio paslaugą. Toliau pateikiama techninė informacija, kaip įdiegti žiniatinklio paslaugą, kuri atsako į užklausas pagal:
Kviečiame susieti ir rodyti „MedlinePlus Connect“ grąžintus duomenis. Jūs negalite nukopijuoti „MedlinePlus“ puslapių į savo svetainę. Jei naudojate „MedlinePlus Connect“ žiniatinklio tarnybos duomenis, nurodykite, kad informacija yra iš „MedlinePlus.gov“, tačiau nenaudokite „MedlinePlus“ logotipo arba kitaip nurodykite, kad „MedlinePlus“ pritaria jūsų konkrečiam produktui. Norėdami sužinoti daugiau, žr. NLM API puslapį. Norėdami gauti daugiau informacijos apie tai, kaip susieti su „MedlinePlus“ turiniu už šios paslaugos ribų, žiūrėkite mūsų susiejimo gaires ir instrukcijas.
Jei nuspręsite naudoti „MedlinePlus Connect“, prisiregistruokite gauti el. Pašto sąrašą, kad neatsiliktumėte nuo pokyčių ir keistumėtės idėjomis su savo kolegomis. Susisiekite su mumis, jei įdiegiate „MedlinePlus Connect“.
Žiniatinklio paslaugos apžvalga
Žiniatinklio paslaugų užklausų parametrai atitinka HL7 konteksto žinojimo žinių paieškos (informacijos mygtuko) žinių užklausos URL pagrįsto diegimo vadovą. „REST“ pagrįstas atsakymas atitinka „HL7 Context-Aware Knowledge Retrieval (Infobutton)“ į paslaugas orientuoto architektūros diegimo vadovą. Užklausos išvestis gali būti XML „Atom“ sklaidos kanalo formatu, JSON arba JSONP.
Užklausos struktūra nurodo, kokio tipo kodą siunčiate. Visais atvejais pagrindinis žiniatinklio paslaugos URL yra: https://connect.medlineplus.gov/service
„MedlinePlus Connect“ naudoja HTTPS ryšius. HTTP užklausos nebus priimamos, o esami diegimai, naudojant HTTP, turėtų būti atnaujinti į HTTPS.
Išvesties parametrai
Šie parametrai yra neprivalomi. Jei jų nepaliksite, numatytasis atsakymas yra XML formato informacija anglų kalba.
Kalba
Nurodykite, ar norite, kad atsakymas būtų pateiktas anglų ar ispanų kalbomis. „MedlinePlus Connect“ laikys, kad anglų kalba yra kalba, jei ji nėra nurodyta.
Jei norite, kad atsakymas į problemos kodo paiešką būtų pateiktas ispanų kalba, naudokite: informationRecipient.languageCode.c = es
(= taip pat priimtas sp)
Jei norite nurodyti anglų kalbą, naudokite: informationRecipient.languageCode.c = lt
Formatas
Nurodykite, ar norite, kad atsakymo formatas būtų XML, JSON ar JSONP. XML yra numatytasis.
- Norėdami paprašyti JSON, naudokite:
- žiniųResponseType = programa / json
- JSONP naudokite:
- knowledgeResponseType = application / javascript & callback = CallbackFunction, kai CallbackFunction yra vardas, kurį suteikiate atgalinio skambinimo funkcija.
- Norėdami gauti atsakymą XML, naudokite:
- žiniųResponseType = text / xml arba palikite parametrą knowResponseType užklausoje.
Prašymai nustatyti diagnozės (problemos) kodus
Norėdami gauti problemos kodą, „MedlinePlus Connect“ grąžins nuorodas ir informaciją iš „MedlinePlus“ sveikatos temų puslapių, genetikos puslapių ar kitų NIH institutų puslapių.
„MedlinePlus Connect“ pateiks:
Ne visada kiekvienas kodas gali atitikti. Tokiais atvejais „MedlinePlus Connect“ pateiks niekinį atsakymą.
Pagrindinis paslaugos URL yra: https://connect.medlineplus.gov/service
Bet kuriai šios paslaugos užklausai reikalingi du parametrai:
- Kodo sistema
Nurodykite problemos kodo sistemą, kurią naudosite.- Naudojant TLK-10-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- Naudojant TLK-9-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- Naudojant SNOMED CT:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Kodas
Nurodykite tikrąjį kodą, kurio bandote ieškoti:
mainSearchCriteria.v.c = 250.33
Neprivalomi parametrai
Kodo pavadinimas
Taip pat galite nustatyti problemos kodo pavadinimą / pavadinimą. Tačiau ši informacija neturi įtakos atsakymui (skirtingai nei „MedlinePlus Connect“ žiniatinklio programa, kurioje gali būti naudojama vardo / pavadinimo informacija). mainSearchCriteria.v.dn = Cukrinis diabetas su kitu 1 tipo koma nekontroliuojama. Išsamesnės informacijos apie kalbą ir išvesties formatus rasite aukščiau esančiame skyriuje Išvesties parametrai
Pasirinktų „Atom“ elementų (arba JSON objektų) aprašymas atsakant į problemos kodo užklausas
| Elementas | Klasės mazgas | apibūdinimas |
|---|---|---|
| pavadinimas | Atitinkamo „MedlinePlus“ sveikatos temos puslapio arba GHR puslapio pavadinimas | |
| nuoroda | Atitinkamo „MedlinePlus“ sveikatos temos puslapio arba GHR puslapio URL | |
| santrauka | Visa sveikatos temos santrauka. Tai apima įterptąsias nuorodas į kitas svarbias sveikatos temas ir visą formatavimą, įskaitant ženklelius ir tarpų tarp pastraipų. Santrauka yra HTML. GHR puslapiams pateikiamas pirmasis viso puslapio skyrius. | |
| santrauka | Temos sinonimai. Sveikatos temos puslapyje jie vadinami „Taip pat vadinami“. Ne visose temose yra terminai „Taip pat vadinami“. | |
| santrauka | Santraukos teksto priskyrimo patvirtinimas, jei didžioji dalis santraukos buvo iš kitos federalinės agentūros. Ne visos santraukos turi priskyrimą. Nepriskirtas tekstas yra „MedlinePlus“ originalas. | |
| santrauka | Pasirinktos nuorodos, susijusios su tema. Tai apima puslapio pavadinimą, URL ir susietą organizaciją (kai taikoma). Nuorodos suformatuotos sąraše su ženkleliais. Ne visos temos turi šias nuorodas. Nuorodų skaičius gali svyruoti nuo nulio iki dešimčių. |
Užklausų dėl problemų kodų pavyzdžiai
Visiškas ispanakalbio paciento prašymas dėl cukrinio diabeto su kitu nekontroliuojamu 1 tipo koma, TLK-9 kodu 250,33, turėtų šį URL adresą: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = cukrinis diabetas% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20controlated & informationRecipient.languageCode.c = es
Pacientas su ta pačia diagnoze, bet prašomas formatas yra JSON, o kalba yra anglų: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / Json
Pacientas, kuriam diagnozuota „Pneumonija dėl Pseudomonas“, naudojant SNOMED CT kodą 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonija% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = lt
Pacientas, turintis tą pačią diagnozę, tačiau prašomas formatas yra JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=
Susijusios paslaugos ir bylos
Norėdami gauti „MedlinePlus“ sveikatos temas atsakydami į teksto užklausas, o ne į problemų kodus, ištirkite „MedlinePlus“ žiniatinklio paslaugą. Be to, jei jums reikia viso „MedlinePlus“ sveikatos temų rinkinio XML formatu, peržiūrėkite mūsų XML failų puslapį.
Prašymai pateikti informacijos apie vaistus
Gavę RXCUI, „MedlinePlus Connect“ pateikia geriausias informacijos apie narkotikus atitikmenis. Tai taip pat suteikia gerų rezultatų gaunant NDC kodą. „MedlinePlus Connect“ gali pateikti atsakymus anglų arba ispanų kalbomis.
Jei norite gauti informacijos apie vaistus anglų kalba, jei nesiunčiate NDC ar RXCUI arba jei nerandame atitikties pagal kodą, programa naudos jūsų siųstą teksto eilutę, kad būtų rodomos geriausios informacijos apie vaistus. Jei norite gauti informacijos apie ispanų vaistus, „MedlinePlus Connect“ atsako tik į NDC ar RXCUI ir nenaudoja tekstinių eilučių. Galima atsakyti angliškai, bet atsakyti ispaniškai negalima.
„MedlinePlus Connect“ žiniatinklio tarnyba grąžins:
Gali būti keli atsakymai į vieną vaistų prašymą. Ne visada kiekviena užklausa gali atitikti. Tokiais atvejais „MedlinePlus Connect“ pateiks niekinį atsakymą.
Jei norite gauti informacijos apie narkotikus, pagrindinis URL yra: https://connect.medlineplus.gov/service
Norėdami išsiųsti užklausą, įtraukite šią informaciją:
- Kodo sistema
Nurodykite siunčiamo vaisto kodo tipą. (Būtina anglų ir ispanų kalboms)- Naudojant RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Naudojant NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Kodas
Nurodykite tikrąjį kodą, kurio bandote ieškoti. (Pageidaujama anglų kalba, būtina ispanų kalba)
mainSearchCriteria.v.c = 637188 - Vaisto pavadinimas
Nurodykite vaisto pavadinimą teksto eilute. (Neprivaloma anglų kalba, nenaudojama ispanų kalbai)
mainSearchCriteria.v.dn = „Chantix“ 0,5 mg geriamoji tabletė
Neprivalomi parametrai
Kodo pavadinimasSiųsdami užklausą dėl informacijos anglų kalba, galite įtraukti pasirinktinį vaisto pavadinimo parametrą. Tai išsamiai aprašyta ankstesniame skyriuje. mainSearchCriteria.v.dn = „Chantix“ 0,5 mg geriamoji tabletė
Išsamesnę informaciją apie kalbą ir išvesties formatus rasite aukščiau esančiame skyriuje „Išvesties parametrai“.
Pasirinktų atominių elementų (arba JSON objektų) aprašymas atsakant į vaistų užklausas
| Elementas | apibūdinimas |
|---|---|
| pavadinimas | Atitikusio „MedlinePlus“ vaistų puslapio pavadinimas |
| nuoroda | Atitikusio „MedlinePlus“ vaistų puslapio URL |
| autorius | Šaltinio priskyrimas informacijai apie vaistus |
Prašymų pateikti narkotikų kodus pavyzdžiai
Jūsų vaistų informacijos užklausa turėtų atrodyti kaip viena iš šių.
Norėdami paprašyti informacijos per RXCUI, jūsų užklausa turėtų atrodyti taip: 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 = lt
Norėdami paprašyti informacijos iš NDC apie ispanų kalbėtoją, jūsų prašymas turėtų atrodyti taip: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es
Norėdami išsiųsti teksto eilutę be vaistų kodo, turite nurodyti savo užklausą kaip NDC tipo užklausą, kad „MedlinePlus Connect“ žinotų, kad ieškote informacijos apie vaistus. Tai veiks tik angliškoms užklausoms. Jūsų užklausa gali atrodyti taip: 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 = lt
Prašymai pateikti informaciją apie laboratorinius tyrimus
„MedlinePlus Connect“ pateikia laboratorinių tyrimų informacijos atitikmenis, kai gauna LOINC užklausą. Paslauga gali pateikti atsakymą anglų arba ispanų kalbomis.
„MedlinePlus Connect“ žiniatinklio tarnyba grąžins:
Ne visada kiekvienas kodas gali atitikti. Tokiais atvejais „MedlinePlus Connect“ pateiks niekinį atsakymą.
Pagrindinis paslaugos URL yra: https://connect.medlineplus.gov/service
Tai yra du būtini bet kurios šios paslaugos laboratorinių tyrimų užklausos parametrai:
- Kodo sistema
- Nustatykite, kad naudojate LOINC kodų sistemą. Naudokite:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- „MedlinePlus Connect“ taip pat priims:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Kodas
nustatykite faktinį kodą, kurio bandote ieškoti:
mainSearchCriteria.v.c = 3187-2
Neprivalomi parametrai
Kodo pavadinimasTaip pat galite nustatyti laboratorinio tyrimo pavadinimą. Tačiau ši informacija neturi įtakos atsakymui. mainSearchCriteria.v.dn = IX faktoriaus tyrimas
Išsamesnę informaciją apie kalbą ir išvesties formatus rasite aukščiau esančiame skyriuje „Išvesties parametrai“.
Pasirinktų atomo elementų (arba JSON objektų) aprašymas atsakant į laboratorinių bandymų užklausas
| Elementas | apibūdinimas |
|---|---|
| pavadinimas | Atitinkamo „MedlinePlus“ laboratorinio tyrimo puslapio pavadinimas |
| nuoroda | Atitikusio „MedlinePlus“ laboratorinio tyrimo puslapio URL |
| santrauka | Ištrauka iš puslapio turinio |
| autorius | Laboratorinio tyrimo turinio šaltinio priskyrimas |
Prašymų atlikti laboratorinius tyrimus pavyzdžiai
Jei norite paprašyti informacijos angliškai kalbančiam asmeniui, jūsų užklausa gali atrodyti viena iš šių: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = faktorius% 20IX% 20assay & informationRecipient.languageCode.c = lt https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language = lt
Jei norite paprašyti informacijos ispanų kalba, jūsų užklausa gali atrodyti kaip viena iš šių: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = faktorius% 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
Priimtino naudojimo politika
Norint išvengti „MedlinePlus“ serverių perkrovos, NLM reikalauja, kad „MedlinePlus Connect“ vartotojai siunčia ne daugiau kaip 100 užklausų per minutę vienam IP adresui. Užklausos, viršijančios šią ribą, nebus aptarnaujamos ir aptarnavimas nebus atkurtas 300 sekundžių arba kol užklausų rodiklis nesieks ribos, atsižvelgiant į tai, kas įvyks vėliau. Norėdami apriboti užklausų, kurias siunčiate į „Connect“, skaičių, NLM rekomenduoja 12–24 valandų laikotarpio talpyklos rezultatus.
Ši politika taikoma siekiant užtikrinti, kad paslauga išliktų prieinama ir prieinama visiems vartotojams. Jei turite konkretų naudojimo atvejį, dėl kurio jums reikia siųsti daug užklausų „MedlinePlus Connect“ ir tokiu būdu viršyti šioje politikoje nurodytą užklausų normos limitą, susisiekite su mumis. NLM darbuotojai įvertins jūsų prašymą ir nustatys, ar gali būti suteikta išimtis. Taip pat peržiūrėkite „MedlinePlus XML“ failų dokumentus. Šiuose XML failuose yra visi sveikatos temos įrašai ir jie gali būti alternatyvus būdas pasiekti „MedlinePlus“ duomenis.
Daugiau informacijos
Rekomenduota Jums
5 biurui tinkami užkandžiai, kurie pašalina popietės nuosmukį