MedlinePlus Connect: Vefþjónusta
Efni.
- Yfirlit vefþjónustunnar
- Output Parameters
- Beiðnir um greiningarkóða (vandamál)
- Valfrjálsar breytur
- Lýsing á völdum atómþáttum (eða JSON hlutum) sem svar við beiðnum um vandamálskóða
- Dæmi um beiðnir um vandamálskóða
- Tengd þjónusta og skrár
- Beiðnir um lyfjaupplýsingar
- Valfrjálsar breytur
- Lýsing á völdum atómþáttum (eða JSON hlutum) í svari við lyfjabeiðnum
- Dæmi um beiðnir um lyfjakóða
- Beiðnir um upplýsingar um rannsóknarstofupróf
- Valfrjálsar breytur
- Lýsing á völdum atómþáttum (eða JSON hlutum) í svari við rannsóknarprófbeiðnum
- Dæmi um beiðnir um rannsóknir á rannsóknum
- Viðunandi notkunarstefna
- Meiri upplýsingar
MedlinePlus Connect er fáanlegt sem vefforrit eða vefþjónusta. Hér að neðan eru tæknilegar upplýsingar til að innleiða vefþjónustuna, sem svarar beiðnum sem byggjast á:
Þér er velkomið að tengja á og birta gögnin sem MedlinePlus Connect skilar. Þú mátt ekki afrita MedlinePlus síður á síðuna þína. Ef þú notar gögn frá MedlinePlus Connect vefþjónustunni, vinsamlegast gefðu til kynna að upplýsingarnar séu frá MedlinePlus.gov en ekki nota MedlinePlus merkið eða á annan hátt gefa í skyn að MedlinePlus styðji tiltekna vöru þína. Vinsamlegast skoðaðu API síðu NLM til að fá frekari leiðbeiningar. Nánari upplýsingar um hvernig tengja má MedlinePlus efni utan þessarar þjónustu er að finna í leiðbeiningum okkar og leiðbeiningum um tengingu.
Ef þú ákveður að nota MedlinePlus Connect skaltu skrá þig á netfangalistann til að fylgjast með þróuninni og skiptast á hugmyndum við kollega þína. Vinsamlegast segðu okkur hvort þú framkvæmir MedlinePlus Connect með því að hafa samband við okkur.
Yfirlit vefþjónustunnar
Færibreytur fyrir vefþjónustubeiðnir eru í samræmi við HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation Guide. Viðbrögðin sem byggjast á REST eru í samræmi við HL7 samhengismeðvitaða þekkingarleit (Infobutton) þjónustumiðaða leiðbeiningar um byggingarlist. Framleiðsla beiðninnar getur verið XML á Atom straumsniði, JSON eða JSONP.
Uppbygging beiðninnar gefur til kynna hvaða tegund kóða þú sendir. Í öllum tilvikum er grunnslóð vefþjónustunnar: https://connect.medlineplus.gov/service
MedlinePlus Connect notar HTTPS tengingar. HTTP beiðnir verða ekki samþykktar og núverandi útfærslur með HTTP ættu að uppfæra í HTTPS.
Output Parameters
Þessar breytur eru valfrjálsar. Ef þú skilur þau eftir eru sjálfgefin svör enskar upplýsingar á XML sniði.
Tungumál
Greindu hvort þú vilt að svarið sé á ensku eða spænsku. MedlinePlus Connect mun gera ráð fyrir að enska sé tungumálið ef það er ekki tilgreint.
Ef þú vilt að viðbrögðin við leit að vandamálakóða séu á spænsku skaltu nota: informationRecipient.languageCode.c = es
(= sp einnig samþykkt)
Notaðu eftirfarandi til að tilgreina ensku: informationRecipient.languageCode.c = en
Snið
Auðkenndu hvort þú vilt að svarsniðið sé XML, JSON eða JSONP. XML er sjálfgefið.
- Til að biðja um JSON, notaðu:
- knowledgeResponseType = umsókn / json
- Notaðu fyrir JSONP:
- knowledgeResponseType = application / javascript & callback = CallbackFunction þar sem CallbackFunction er nafn sem þú gefur aftur aðgerðina.
- Til að fá svar í XML, notaðu:
- knowledgeResponseType = text / xml eða láttu breytuna knowledgeResponseType vera utan beiðninnar.
Beiðnir um greiningarkóða (vandamál)
Til að fá vandamálakóða mun MedlinePlus Connect skila krækjum og upplýsingum frá MedlinePlus umfjöllun um heilsufar, erfðasíðum eða síðum frá öðrum NIH stofnunum.
MedlinePlus Connect mun skila eftirfarandi:
Það er kannski ekki alltaf samsvörun fyrir hvern kóða. Í þeim tilvikum mun MedlinePlus Connect skila núllsvörun.
Grunnslóð þjónustunnar er: https://connect.medlineplus.gov/service
Það eru tvær nauðsynlegar breytur fyrir allar fyrirspurnir um þessa þjónustu:
- Kóða kerfi
Þekkið vandamálakóðakerfið sem þú munt nota.- Fyrir ICD-10-CM notkun:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- Fyrir ICD-9-CM notkun:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- Fyrir SNOMED CT notkun:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Kóði
Greindu raunverulegan kóða sem þú ert að reyna að fletta upp:
mainSearchCriteria.v.c = 250.33
Valfrjálsar breytur
Titill kóða
Þú getur einnig bent á nafn / titil vandamálakóðans. Þessar upplýsingar hafa þó ekki áhrif á svörunina (ólíkt MedlinePlus Connect vefforritinu þar sem hægt er að nota upplýsingar um nafn / titil). mainSearchCriteria.v.dn = Sykursýki með annarri dágerð 1 stjórnlaus Sjá hlutann hér að ofan um framleiðslufæribreytur til að fá upplýsingar um tungumál og framleiðslusnið.
Lýsing á völdum atómþáttum (eða JSON hlutum) sem svar við beiðnum um vandamálskóða
| Element | Flokks hnút | Lýsing |
|---|---|---|
| titill | Titill samsvarandi heilsuefnasíðu MedlinePlus eða GHR síðu | |
| hlekkur | Vefslóð fyrir samsvarandi MedlinePlus heilsusíðu eða GHR síðu | |
| samantekt | Samantektin fyrir heilsuefnið. Þetta felur í sér innfellda hlekki á önnur viðeigandi heilsuefni og allt snið, þ.mt byssukúlur og málsgreinar. Yfirlitið er í HTML. Fyrir GHR síður er fyrsti hluti heilsíðu. | |
| samantekt | Samheiti yfir efnið. Þetta er vísað til sem "Einnig kallað" á síðu um heilsufar. Ekki eru öll efni með „Einnig kallað“ hugtök. | |
| samantekt | Viðurkenningar viðurkenningar fyrir yfirlitstexta, ef meirihluti yfirlitsins var frá annarri alríkisstofnun. Ekki eru allar samantektir tilgreindar. Óaðfærður texti er frumlegur frá MedlinePlus. | |
| samantekt | Valdir krækjur sem tengjast viðfangsefninu. Þetta felur í sér síðuheiti, slóð og tengd skipulag (þegar við á). Krækjurnar eru sniðnar í punktalista. Ekki eru öll efni með þessa krækjur. Fjöldi tengla getur verið frá núlli upp í tugi. |
Dæmi um beiðnir um vandamálskóða
Heildarbeiðni um sykursýki með öðrum dái af tegund 1 ómeðhöndluð, ICD-9 kóða 250.33, fyrir spænskumælandi sjúkling myndi hafa eftirfarandi slóð: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Sykursýki% 20 mellitus% 20 með% 20 öðrum% 20 coma% 20 tegund% 201% 20 óstýrðum og informationRecipient.languageCode.c = es
Sjúklingur með sömu greiningu en umbeðið snið er JSON og tungumálið er enska: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json
Sjúklingur greindur með „Lungnabólga vegna Pseudomonas“ með SNOMED CT kóða 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Lungnabólga% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = en
Sjúklingur með sömu greiningu en umbeðið snið er JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFallback
Tengd þjónusta og skrár
Til að fá MedlinePlus heilsufarsleg viðbrögð sem svar við textabeiðnum, öfugt við vandamálakóða, skaltu kanna MedlinePlus vefþjónustuna. Einnig, ef þú þarft allt sett af MedlinePlus heilsuefnum á XML sniði, sjáðu XML skrár síðu okkar.
Beiðnir um lyfjaupplýsingar
MedlinePlus Connect veitir bestu samsvörun lyfjaupplýsinga þegar þú færð RXCUI. Það veitir einnig góðan árangur þegar þú færð NDC kóða. MedlinePlus Connect getur veitt svör á ensku eða spænsku.
Ef þú sendir ekki NDC eða RXCUI eða ef við finnum enga samsvörun byggða á kóðanum fyrir beiðnir um upplýsingar um lyf, mun forritið nota textastrenginn sem þú sendir til að sýna bestu upplýsingar um lyfjameðferð. Fyrir beiðnir um upplýsingar um spænsk lyf, bregst MedlinePlus Connect aðeins við NDC eða RXCUI og notar ekki textastreng. Það er hægt að hafa svar á ensku en ekkert svar á spænsku.
Vefþjónustan MedlinePlus Connect mun skila eftirfarandi:
Það gætu verið mörg svör við einni lyfbeiðni. Það er kannski ekki alltaf samsvörun fyrir hverja beiðni. Í þeim tilvikum mun MedlinePlus Connect skila núllsvörun.
Fyrir beiðnir um lyfjaupplýsingar er grunnslóðin: https://connect.medlineplus.gov/service
Til að senda beiðni, láttu þessar upplýsingar fylgja:
- Kóða kerfi
Tilgreindu tegund lyfjakóða sem þú sendir. (Nauðsynlegt fyrir ensku og spænsku)- Fyrir notkun RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Fyrir NDC notkun:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Kóði
Finndu raunverulegan kóða sem þú ert að reyna að fletta upp. (Valið fyrir ensku, nauðsynlegt fyrir spænsku)
mainSearchCriteria.v.c = 637188 - Lyfjanafn
Þekkið nafn lyfsins með textastreng. (Valfrjálst fyrir ensku, ekki notað fyrir spænsku)
mainSearchCriteria.v.dn = Chantix 0,5 MG til inntöku
Valfrjálsar breytur
Titill kóðaÞegar þú sendir beiðni um enskar upplýsingar getur þú látið valfrjálsa færibreytuna fyrir nafn lyfsins fylgja með. Þetta er nánar í ofangreindum kafla. mainSearchCriteria.v.dn = Chantix 0,5 MG til inntöku
Sjá ofangreindan kafla um framleiðslufæribreytur til að fá upplýsingar um tungumál og framleiðslusnið.
Lýsing á völdum atómþáttum (eða JSON hlutum) í svari við lyfjabeiðnum
| Element | Lýsing |
|---|---|
| titill | Titill fyrir samsvarandi lyfjasíðu MedlinePlus |
| hlekkur | Slóð fyrir samsvarandi lyfjasíðu MedlinePlus |
| höfundur | Uppspretta heimildar fyrir upplýsingar um lyf |
Dæmi um beiðnir um lyfjakóða
Beiðni um lyfjaupplýsingar þínar ætti að líta út eins og eftirfarandi.
Til að biðja um upplýsingar með RXCUI ætti beiðni þín að líta svona út: 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 Oral% 20 Tafla og upplýsingar Móttaka.tungukóði.c = en
Til að óska eftir upplýsingum frá NDC fyrir spænskumælandi ætti beiðni þín að líta svona út: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & upplýsingarRecipient.languageCode.c = es
Til að senda textastreng án lyfjakóða verður þú að bera kennsl á fyrirspurn þína sem NDC-gerð beiðni svo MedlinePlus Connect viti að þú ert að leita að lyfjaupplýsingum. Þetta virkar eingöngu fyrir enskar beiðnir. Beiðni þín gæti litið svona út: 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
Beiðnir um upplýsingar um rannsóknarstofupróf
MedlinePlus Connect veitir samsvaranir við upplýsingar um rannsóknarstofu þegar LOINC-beiðni berst. Þjónustan getur veitt svar á ensku eða spænsku.
Vefþjónustan MedlinePlus Connect mun skila eftirfarandi:
Það er kannski ekki alltaf samsvörun fyrir hvern kóða. Í þeim tilvikum mun MedlinePlus Connect skila núllsvörun.
Grunnslóð þjónustunnar er: https://connect.medlineplus.gov/service
Þetta eru tveir nauðsynlegir breytur fyrir allar rannsóknarprófanir fyrir þessa þjónustu:
- Kóða kerfi
- Greindu að þú ert að nota LOINC kóða kerfið. Notaðu:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect mun einnig samþykkja:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Kóði
þekkja raunverulegan kóða sem þú ert að reyna að fletta upp:
mainSearchCriteria.v.c = 3187-2
Valfrjálsar breytur
Titill kóðaÞú getur einnig borið kennsl á nafn rannsóknarstofuprófsins. Þessar upplýsingar hafa þó ekki áhrif á viðbrögðin. mainSearchCriteria.v.dn = Greining þáttar IX
Sjá ofangreindan kafla um framleiðslufæribreytur til að fá upplýsingar um tungumál og framleiðslusnið.
Lýsing á völdum atómþáttum (eða JSON hlutum) í svari við rannsóknarprófbeiðnum
| Element | Lýsing |
|---|---|
| titill | Titill samsvarandi prófunarsíðu MedlinePlus rannsóknarstofu |
| hlekkur | Slóð fyrir samsvarandi prófunarsíðu MedlinePlus rannsóknarstofu |
| samantekt | Brot úr innihaldi síðunnar |
| höfundur | Uppspretta heimildar fyrir innihald rannsóknarprófanna |
Dæmi um beiðnir um rannsóknir á rannsóknum
Til að biðja um upplýsingar fyrir enskumælandi getur beiðni þín litið út eins og eftirfarandi: 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&informationRecipient.languageCode.c = en
Til að biðja um upplýsingar fyrir spænskumælandi getur beiðni þín litið út eins og eftirfarandi: 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.languageCode.c = es
Viðunandi notkunarstefna
Til að koma í veg fyrir ofhleðslu MedlinePlus netþjóna krefst NLM að notendur MedlinePlus Connect sendi ekki meira en 100 beiðnir á mínútu á IP-tölu. Beiðnir sem fara yfir þessi mörk verða ekki þjónustaðar og þjónustan verður ekki endurheimt í 300 sekúndur eða þar til beiðnihlutfallið fer undir mörkin, hvort sem kemur síðar. Til að takmarka fjölda beiðna sem þú sendir til Connect mælir NLM með skyndiminni í 12-24 tíma tíma.
Þessi stefna er til staðar til að tryggja að þjónustan sé áfram tiltæk og aðgengileg öllum notendum. Ef þú ert með sérstakt notkunartilfelli sem krefst þess að þú sendir mikinn fjölda beiðna til MedlinePlus Connect og fer þannig yfir beiðnishlutamörkin sem lýst er í þessari stefnu skaltu hafa samband. Starfsfólk NLM mun meta beiðni þína og ákvarða hvort unnt sé að veita undantekningu. Vinsamlegast skoðaðu einnig skjölin frá MedlinePlus XML skrám. Þessar XML skrár innihalda heilar heilsufarsskrár og geta þjónað sem annar aðferð til að fá aðgang að MedlinePlus gögnum.
Meiri upplýsingar
Við Ráðleggjum
Óléttupróf
