MedlinePlus Connect: web zerbitzua

Alai

• Web zerbitzuaren ikuspegi orokorra
• Irteerako parametroak
• Diagnostiko eskaerak (arazoa) kodeak
• Aukerako parametroak
• Aukeratutako Atomoaren Elementuen deskribapena (edo JSON objektuak) Arazo Kodearen Eskaerei erantzunez
• Arazo Kodeak eskatzeko adibideak
• Lotutako zerbitzuak eta fitxategiak
• Drogei buruzko informazio eskaerak
• Aukerako parametroak
• Aukeratutako Atomoaren Elementuen deskribapena (edo JSON objektuak) botika eskaerei erantzuteko
• Droga-kodeen eskaeren adibideak
• Laborategiko proben informazio eskaerak
• Aukerako parametroak
• Aukeratutako atomo-elementuen deskribapena (edo JSON objektuak) Laborategiko proba eskaerei erantzunez
• Laborategiko probetarako eskaeren adibideak
• Erabilera Politika Onargarria
• Informazio gehiago

MedlinePlus Connect web aplikazio edo web zerbitzu gisa eskuragarri dago. Jarraian, webgunean oinarritutako eskaerei erantzuten dien Web zerbitzua ezartzeko xehetasun teknikoak daude.

MedlinePlus Connect-ek itzulitako datuak estekatu eta bistaratu ditzakezu. Ezin duzu MedlinePlus orrialdeak zure webgunean kopiatu. MedlinePlus Connect Web Zerbitzuko datuak erabiltzen badituzu, adierazi informazioa MedlinePlus.gov-ena dela, baina ez ezazu MedlinePlus logotipoa erabili edo bestela esan nahi duzu MedlinePlusek zure produktu partikularra onartzen duela. Jarraibide gehiago lortzeko, ikusi NLMren API orria. Zerbitzu honetatik kanpoko MedlinePlus edukiarekin lotzeko moduari buruzko informazio gehiago eskuratzeko, ikusi gure jarraibideak eta estekatzeko argibideak.

MedlinePlus Connect erabiltzea erabakitzen baduzu, eman izena posta elektronikoko zerrendan, garapenarekin jarraitzeko eta lankideekin ideiak trukatzeko. Mesedez, esan iezaguzu MedlinePlus Connect ezartzen baduzu gurekin harremanetan jarrita.

Web zerbitzuaren ikuspegi orokorra

Web zerbitzuaren eskaeren parametroak HL7 Context-Aware Knowledge Recuperation (Infobutton) Knowledge Request URLan oinarritutako Ezarpen Gidarekin bat datoz. REST oinarritutako erantzuna HL7 Context-Aware Knowledge Recuperation (Infobutton) Zerbitzuetara zuzendutako Arkitektura Ezartzeko Gidarekin bat dator. Eskaeraren irteera XML izan daiteke Atom feed formatuan, JSON edo JSONP.

Eskaeraren egiturak zer kode mota bidaltzen ari zaren adierazten du. Kasu guztietan, Web zerbitzuaren oinarrizko URLa honako hau da: https://connect.medlineplus.gov/service

MedlinePlus Connect-ek HTTPS konexioak erabiltzen ditu. HTTP eskaerak ez dira onartuko eta HTTP erabiltzen duten inplementazioak HTTPSra eguneratu beharko lirateke.

Irteerako parametroak

Parametro hauek aukerakoak dira. Kanpoan uzten badituzu, lehenetsitako erantzuna ingelesezko informazioa da XML formatuan.

Hizkuntza
Identifikatu erantzuna ingelesez edo gaztelaniaz izatea nahi zenuen. MedlinePlus Connect-ek ingelesa hizkuntza dela hartuko du zehazten ez bada.

Arazoaren kodearen bilaketaren erantzuna gaztelania hutsean izatea nahi baduzu, erabili: informationRecipient.languageCode.c = es
(= sp ere onartzen da)

Ingelesa zehazteko, erabili hau: informationRecipient.languageCode.c = eu

Formatua
Identifikatu erantzun formatua XML, JSON edo JSONP izatea. XML lehenetsia da.

JSON eskatzeko, erabili:

knowledgeResponseType = application / json

JSONPerako, erabili:

knowledgeResponseType = application / javascript & callback = CallbackFunction non CallbackFunction deiak atzera funtzioari ematen diozun izena den.

XMLan erantzun bat lortzeko, erabili:

knowledgeResponseType = text / xml edo utzi knowledgeResponseType parametroa eskaeratik kanpo.

Diagnostiko eskaerak (arazoa) kodeak

Arazo kodea lortzeko, MedlinePlus Connect-ek MedlinePlus osasun gaietako orrietako, genetikako orrien edo NIH Institutuetako beste batzuen estekak eta informazioa itzuliko ditu.

MedlinePlus Connect-ek honako hau itzuliko du:

Agian ez da beti bat etorriko kode bakoitzerako. Kasu horietan, MedlinePlus Connect-ek erantzun nulua emango du.

Zerbitzuaren oinarrizko URLa hau da: https://connect.medlineplus.gov/service

Zerbitzu honetan edozein kontsulta egiteko bi parametro behar dira:

1. Kode Sistema
   Identifikatu erabiliko duzun arazo-kode sistema.

   ICD-10-CM erabilerarako:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   ICD-9-CM erabilerarako:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   SNOMED CT erabiltzeko:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kodea
   Identifikatu bilatzen saiatzen ari zaren benetako kodea:
   mainSearchCriteria.v.c = 250,33

Aukerako parametroak

Kodearen Izenburua
Arazoaren kodearen izena / izenburua ere identifikatu dezakezu. Hala ere, informazio horrek ez du erantzunean eraginik (izenaren / izenburuaren informazioa erabil daitekeen MedlinePlus Connect Web aplikazioan ez bezala). mainSearchCriteria.v.dn = Beste koma mota 1 duten diabetes mellitusa kontrolik gabe Ikusi hizkuntza eta irteerako formatuen xehetasunak Irteerako parametroei buruzko goiko atala.

Aukeratutako Atomoaren Elementuen deskribapena (edo JSON objektuak) Arazo Kodearen Eskaerei erantzunez

Elementua	Klase nodoa	Deskribapena
Izenburua		Bat datorren MedlinePlus osasun gaiaren orrialdearen edo GHR orriaren izenburua
esteka		Bat datorren MedlinePlus osasun gaiaren orria edo GHR orriaren URLa
laburpen		Osasun gaiaren laburpen osoa. Honek osasuneko beste gai garrantzitsu batzuetarako esteka txertatuak eta formatu guztia barne hartzen ditu, puntu eta tartekien barne. Laburpena HTML formatuan dago. GHR orrietarako, orri osoaren lehen atala eskaintzen da.
laburpen		Gaiaren sinonimoak. Osasun gaiaren orrialdean "Ere deitzen zaie" esaten zaie. Gai guztiek ez dituzte "Ere deitzen" terminoak.
laburpen		Laburpen-testuaren aitorpena, laburpenaren gehiengoa beste agentzia federal batekoa izanez gero. Laburpen guztiek ez dute atribuziorik. Egiaztatu gabeko testua jatorrizkoa da MedlinePlus-en.
laburpen		Gaiari lotutako estekak. Honek orriaren izena, URLa eta lotutako erakundea (hala badagokio) barne hartzen ditu. Estekak puntako zerrenda batean formateatuta daude. Gai guztiek ez dituzte esteka horiek. Lotura kopurua zero eta dozenaka bitartekoa izan daiteke.

Arazo Kodeak eskatzeko adibideak

Kontrolik gabeko beste koma motako 1 Diabetes Mellitus-erako eskaera osoak, 250.33 ICD-9 kodea, gaixo erdaldun batek URL helbide hau izango luke: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabetes% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20uncontrolled & informationRecipient.languageCode.c = es

Diagnostiko berdina duen baina eskatutako formatua duen pazientea JSON da eta hizkuntza ingelesa da: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

SNOMED CT kodea 41381004 erabiliz "Pseudomonasengatik eragindako Pneumonia" diagnostikatu zaion gaixoari: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria Pneumonia% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = eu

Diagnostiko bera duen baina eskatutako formatua duen gaixo bat JSONP da: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=Callback

Lotutako zerbitzuak eta fitxategiak

MedlinePlus osasun gaiak testu eskaerei erantzunez jasotzeko, arazo kodeei ez bezala, ikertu MedlinePlus Web zerbitzua. Gainera, MedlinePlus osasun gaien multzo osoa XML formatuan behar baduzu, ikusi gure XML fitxategien orria.

Drogei buruzko informazio eskaerak

MedlinePlus Connect-ek RXCUI bat jasotzerakoan sendagaien informazio-partida onenak eskaintzen ditu. Emaitza onak ere ematen ditu NDC kodea jasotzean. MedlinePlus Connect-ek ingelesez edo gaztelaniaz eman ditzake erantzunak.

Ingelesezko botiken informazioa eskatzeko, NDC edo RXCUI bat bidaltzen ez baduzu edo kodean oinarritutako bat etortzerik aurkitzen ez badugu, aplikazioak bidalitako testu-katea erabiliko du sendagaien informazioarekin bat etortzeko. Medikazio espainiarrei buruzko informazioa jasotzeko, MedlinePlus Connect-ek NDC edo RXCUI-ei soilik erantzuten die eta ez ditu testu kateak erabiltzen. Posible da erantzun bat ingelesez izatea, baina erantzunik ez gaztelaniaz.

MedlinePlus Connect Web zerbitzuak honako hau itzuliko du:

Botika eskaera bati erantzun ugari eman dakioke. Eskaera bakoitzerako ez da beti bat etorriko. Kasu horietan, MedlinePlus Connect-ek erantzun nulua emango du.

Drogei buruzko informazioa eskatzeko, oinarrizko URLa hau da: https://connect.medlineplus.gov/service

Eskaera bidaltzeko, sartu informazio zati hauek:

1. Kode Sistema
   Identifikatu bidaltzen ari zaren botika kodea. (Beharrezkoa ingelesez eta gaztelaniaz)
   

   RXCUI erabiltzeko:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   NDC erabiltzeko:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect-ek ingelesez botiken informazioa eskatzeko testu katea ere onar dezake, baina botiken informazioa bilatzen ari zarela adierazi behar duzu goian zerrendatutako bi kode sistemetako bat sartuz.
2. Kodea
   Identifikatu bilatzen saiatzen ari zaren benetako kodea. (Ingeleserako hobetsia, gaztelerarako derrigorrezkoa)
   mainSearchCriteria.v.c = 637188
3. Droga izena
   Identifikatu drogaren izena testu kate batekin. (Aukerakoa ingeleserako, ez da erabiltzen gaztelaniarako)
   mainSearchCriteria.v.dn = Chantix 0,5 MG Ahozko Tableta

Gutxienez, kode sistema eta kodea identifikatu beharko zenituzke, edo kode sistema eta botikaren izena. Bidali hirurak ingelesezko eskaeretarako emaitzarik onenak lortzeko. Bidali kode sistema eta gaztelaniazko eskaeren kodea.

Aukerako parametroak

Kodearen Izenburua

Ingelesezko informazio eskaera bidaltzerakoan, botikaren izenaren aukerako parametroa sar dezakezu. Hori aurreko atalean zehazten da. mainSearchCriteria.v.dn = Chantix 0,5 MG Ahozko Tableta

Ikus Irteerako parametroei buruzko goiko atala hizkuntza eta irteerako formatuen inguruko xehetasunak ikusteko.

Aukeratutako Atomoaren Elementuen deskribapena (edo JSON objektuak) botika eskaerei erantzuteko

Elementua	Deskribapena
Izenburua	Bat datorren MedlinePlus botiken orriaren izenburua
esteka	Bat datorren MedlinePlus botiken orriaren URLa
egilea	Botiken informazioaren iturria egoztea

Droga-kodeen eskaeren adibideak

Botiken informazio eskaerak honako hauetako bat izan beharko luke.

RXCUI batek informazioa eskatzeko, zure eskaerak itxura hau izan beharko luke: 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 = eu

NDC batek espainiar hiztun bati informazioa eskatzeko, zure eskaerak itxura hau izan beharko luke: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Testu katea botikaren koderik gabe bidaltzeko, zure kontsulta NDC motako eskaera gisa identifikatu behar duzu MedlinePlus Connect-ek sendagaien informazioa bilatzen ari zarela jakin dezan. Ingeleseko eskaeretarako bakarrik funtzionatuko du. Zure eskaerak itxura hau izan dezake: 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 = eu

Laborategiko proben informazio eskaerak

MedlinePlus Connect-ek LOINC eskaera jasotzen duenean laborategiko probetako informazioarekin bat etortzen da. Zerbitzuak ingelesez edo gaztelaniaz eman dezake erantzuna.

MedlinePlus Connect Web zerbitzuak honako hau itzuliko du:

Agian ez da beti bat etorriko kode bakoitzerako. Kasu horietan, MedlinePlus Connect-ek erantzun nulua emango du.

Zerbitzuaren oinarrizko URLa hau da: https://connect.medlineplus.gov/service

Hauek dira beharrezkoak diren bi parametro hauek zerbitzu honetako laborategiko probetan kontsultatzeko:

1. Kode Sistema
   

   Identifikatu LOINC kode sistema erabiltzen ari zarela. Erabilera:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect-ek ere onartuko ditu:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kodea
   identifikatu bilatzen saiatzen ari zaren benetako kodea:
   mainSearchCriteria.v.c = 3187-2

Aukerako parametroak

Kodearen Izenburua

Laborategiko probaren izena ere identifikatu dezakezu. Hala ere, informazio horrek ez du erantzunean eraginik. mainSearchCriteria.v.dn = Factor IX saiakuntza

Ikus Irteerako parametroei buruzko goiko atala hizkuntza eta irteerako formatuen inguruko xehetasunak ikusteko.

Aukeratutako atomo-elementuen deskribapena (edo JSON objektuak) Laborategiko proba eskaerei erantzunez

Elementua	Deskribapena
Izenburua	Bat datorren MedlinePlus laborategiko probaren orrialdearen izenburua
esteka	Bat datorren MedlinePlus laborategiko proba orriaren URLa
laburpen	Fragmento orriaren edukitik
egilea	Laborategiko probaren edukiaren iturburua

Laborategiko probetarako eskaeren adibideak

Ingeles hiztun bati informazioa eskatzeko, zure eskaerak honako hauetako bat izan daiteke: 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 = eu

Erdaldun bati informazioa eskatzeko, zure eskaerak honako hauetako bat izan daiteke: 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

Erabilera Politika Onargarria

MedlinePlus zerbitzariak gainkargatzea ekiditeko, NLM-k MedlinePlus Connect-eko erabiltzaileek minutu bakoitzeko 100 eskaera baino gehiago bidaltzea eskatzen du IP helbide bakoitzeko. Muga hori gainditzen duten eskaerei ez zaie zerbitzua emango eta zerbitzua ez da leheneratuko 300 segundotan edo eskaera tasa mugaren azpira jaitsi arte, gero datorrena. Connectera bidalitako eskaera kopurua mugatzeko, NLM-k emaitzak 12-24 orduko cache emaitzak gomendatzen ditu.

Politika hau zerbitzua erabiltzaile guztientzat eskuragarri eta eskuragarri izaten jarraitzeko dago. MedlinePlus Connect-era eskaera ugari bidaltzea eskatzen duen erabilera kasu zehatzik baduzu eta, beraz, politika honetan zehaztutako eskaera tasaren muga gainditzea, jarri gurekin harremanetan. NLMko langileek zure eskaera ebaluatuko dute eta salbuespenen bat eman daitekeen zehaztuko dute. Mesedez, berrikusi MedlinePlus XML fitxategien dokumentazioa. XML fitxategi hauek osasun gaien erregistro osoak dituzte eta MedlinePlus datuetara sartzeko ordezko metodo gisa balio dezakete.

Informazio gehiago