MedlinePlus Connect: Reta Servo

Enhavo

• Retserva Superrigardo
• Eliraj Parametroj
• Petoj pri Diagnozaj (Problemaj) Kodoj
• Laŭvolaj Parametroj
• Priskribo de Elektitaj Atom-Elementoj (aŭ JSON-objektoj) en Respondo al Problemaj Kodaj Petoj
• Ekzemploj de Petoj pri Problemaj Kodoj
• Rilataj Servoj kaj Dosieroj
• Petoj pri Drogaj Informoj
• Laŭvolaj Parametroj
• Priskribo de Elektitaj Atom-Elementoj (aŭ JSON-objektoj) en Respondo al Medikamentaj Petoj
• Ekzemploj de Petoj pri Drogaj Kodoj
• Petoj pri Informoj pri Laboratoriaj Testoj
• Laŭvolaj Parametroj
• Priskribo de Elektitaj Atom-Elementoj (aŭ JSON-objektoj) en Respondo al Laboratoriotestaj Petoj
• Ekzemploj de Petoj pri Laboratoriaj Testoj
• Akceptebla Uza Politiko
• Pliaj Informoj

MedlinePlus Connect disponeblas kiel TTT-aplikaĵo aŭ TTT-servo. Malsupre estas la teknikaj detaloj por efektivigi la interretan servon, kiu respondas al petoj bazitaj sur:

Vi bonvenas ligi kaj montri la datumojn resenditajn de MedlinePlus Connect. Vi ne rajtas kopii paĝojn de MedlinePlus al via retejo. Se vi uzas datumojn de la Reteja Servo MedlinePlus Connect, bonvolu indiki, ke la informoj estas de MedlinePlus.gov sed ne uzas la emblemon de MedlinePlus aŭ alimaniere implicas, ke MedlinePlus aprobas vian apartan produkton. Bonvolu vidi la paĝon API de NLM por plua gvidado. Por pliaj informoj pri kiel ligi al MedlinePlus-enhavo ekster ĉi tiu servo, bonvolu vidi niajn gvidliniojn kaj instrukciojn pri ligado.

Se vi decidas uzi MedlinePlus Connect, aliĝu al la retpoŝta listo por resti laŭ la evoluoj kaj interŝanĝi ideojn kun viaj kolegoj. Bonvolu diri al ni, ĉu vi efektivigas MedlinePlus Connect kontaktante nin.

Retserva Superrigardo

La parametroj por la retservaj petoj konformas al la Gvidilo pri Realigado de Scio pri URL-Konteksta-Konscia (Infobutono) HL7. La REST-bazita respondo konformas al la HL7-Kunteksta-Konscia Scia Rekuperado (Informobutono) Serv-Orientita Arkitektura Efektiviga Gvidilo. La eliro de la peto povas esti XML en la formato Atom, JSON aŭ JSONP.

La strukturo de la peto indikas kian kodon vi sendas. En ĉiuj kazoj, la baza URL por la TTT-servo estas: https://connect.medlineplus.gov/service

MedlinePlus Connect uzas HTTPS-ligojn. HTTP-petoj ne estos akceptitaj kaj ekzistantaj efektivigoj per HTTP devas ĝisdatigi al HTTPS.

Eliraj Parametroj

Ĉi tiuj parametroj estas nedevigaj. Se vi forlasas ilin, la defaŭlta respondo estas anglaj informoj en XML-formato.

Lingvo
Identigu, ĉu vi ŝatus, ke la respondo estu en la angla aŭ la hispana. MedlinePlus Connect supozos ke la angla estas la lingvo se ĝi ne estas specifita.

Se vi volas, ke la respondo al la problemkoda serĉado estu en la hispana, uzu: informationRecipient.languageCode.c = es
(= sp ankaŭ akceptita)

Por specifi la anglan, uzu jenon: informationRecipient.languageCode.c = en

Formato
Identigu se vi ŝatus, ke la respondo-formato estu XML, JSON aŭ JSONP. XML estas la apriora.

Por peti JSON, uzu:

knowledgeResponseType = apliko / json

Por JSONP, uzu:

knowledgeResponseType = application / javascript & callback = CallbackFunction kie CallbackFunction estas nomo, kiun vi donas al la revoka funkcio.

Por respondo en XML, uzu:

knowledgeResponseType = teksto / xml aŭ lasu la parametron knowledgeResponseType ekster la peto.

Petoj pri Diagnozaj (Problemaj) Kodoj

Por problemkodo, MedlinePlus Connect resendos ligojn kaj informojn de MedlinePlus-sanaj tempaĝoj, genetikaj paĝoj aŭ paĝoj de aliaj NIH-Institutoj.

MedlinePlus Connect redonos la jenon:

Eble ne ĉiam ekzistas kongruo por ĉiu kodo. En tiuj kazoj, MedlinePlus Connect redonos nulan respondon.

La baza URL de la servo estas: https://connect.medlineplus.gov/service

Estas du bezonataj parametroj por iu ajn demando pri ĉi tiu servo:

1. Koda Sistemo
   Identigu la probleman kodosistemon, kiun vi uzos.

   Por ICD-10-CM uzi:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Por ICD-9-CM uzi:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Por SNOMED CT uzu:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kodo
   Identigu la realan kodon, kiun vi provas serĉi:
   mainSearchCriteria.v.c = 250.33

Laŭvolaj Parametroj

Koda Titolo
Vi ankaŭ povas identigi la nomon / titolon de la problemkodo. Tamen ĉi tiuj informoj ne efikas sur la respondo (male al la reteja programo MedlinePlus Connect, kie la nomo / titolaj informoj povas esti uzataj). mainSearchCriteria.v.dn = Diabeto kun alia koma tipo 1 nekontrolita Vidu la supran sekcion pri Eliraj Parametroj por detaloj pri lingvo kaj eliraj formatoj.

Priskribo de Elektitaj Atom-Elementoj (aŭ JSON-objektoj) en Respondo al Problemaj Kodaj Petoj

Elemento	Klasnodo	Priskribo
titolo		Titolo de egala paĝo pri sanitemo MedlinePlus aŭ paĝo GHR
ligo		URL por kongrua paĝo pri sanitemo MedlinePlus aŭ paĝo GHR
resumo		La kompleta resumo pri la sana temo. Ĉi tio inkluzivas enigitajn ligojn al aliaj koncernaj sanaj temoj, kaj ĉiujn formatojn, inkluzive de kugloj kaj alineo-interspaco. La resumo estas en HTML. Por GHR-paĝoj, la unua sekcio de la kompleta paĝo estas provizita.
resumo		Sinonimoj por la temo. Ĉi tiuj estas nomataj "Ankaŭ nomataj" sur sanpaĝa paĝo. Ne ĉiuj temoj havas "Ankaŭ nomitajn" terminojn.
resumo		Agnosko de atribuo por resuma teksto, se la plimulto de la resumo estis de alia federacia agentejo. Ne ĉiuj resumoj havas atribuon. Neatribuita teksto estas originala por MedlinePlus.
resumo		Elektitaj ligoj asociitaj kun la temo. Ĉi tio inkluzivas la paĝan nomon, URL kaj rilatan organizon (kiam aplikebla). La ligoj estas formatitaj en kugla listo. Ne ĉiuj temoj havas ĉi tiujn ligojn. La nombro de ligoj povas varii de nulo ĝis dekoj.

Ekzemploj de Petoj pri Problemaj Kodoj

Kompleta peto pri Diabeto Mellitus kun alia koma tipo 1 nekontrolita, ICD-9-kodo 250.33, por hispanparolanta paciento havus la jenan URL-adreson: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabeto% 20mellitus% 20kun% 20other% 20coma% 20type% 201% 20uncontrolled & informationRecipient.languageCode.c = es

Paciento kun la sama diagnozo sed la petita formato estas JSON kaj la lingvo estas la angla: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Paciento diagnozita kun "Pneŭmonio pro Pseŭdomonaj" per SNOMED CT-kodo 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.vc Pneumonia% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = eo

Paciento kun la sama diagnozo sed la petita formato estas JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=Callback

Rilataj Servoj kaj Dosieroj

Por ricevi sanajn temojn de MedlinePlus responde al tekstaj petoj, kontraste al problemaj kodoj, esploru la retejon de MedlinePlus. Ankaŭ se vi bezonas la kompletan aron de sanaj temoj de MedlinePlus en XML-formato, vidu nian paĝon pri XML-dosieroj.

Petoj pri Drogaj Informoj

MedlinePlus Connect provizas la plej bonajn drogajn informojn dum ricevo de RXCUI. Ĝi ankaŭ donas bonajn rezultojn ricevante NDC-kodon. MedlinePlus Connect povas doni respondojn en la angla aŭ la hispana.

Por petoj pri anglaj medikamentaj informoj, se vi ne sendas NDC aŭ RXCUI aŭ se ni trovas neniun kongruon bazitan sur la kodo, la aplikaĵo uzos la tekstan ĉenon, kiun vi sendos, por montri la plej bonan kongruan informon pri drogoj. Por petoj pri hispanaj medikamentaj informoj, MedlinePlus Connect respondas nur al NDCs aŭ RXCUIs kaj ne uzas tekstajn ĉenojn. Eblas respondi en la angla sed neniu respondo en la hispana.

La reteja servo MedlinePlus Connect redonos la jenon:

Povus esti multoblaj respondoj al unu medikamenta peto. Eble ne ĉiam ekzistas matĉo por ĉiu peto. En tiuj kazoj, MedlinePlus Connect redonos nulan respondon.

Por petoj pri drogaj informoj, la baza URL estas: https://connect.medlineplus.gov/service

Por sendi peton, inkluzivu ĉi tiujn informojn:

1. Koda Sistemo
   Identigu la specon de medikamenta kodo, kiun vi sendas. (Postulata por la angla kaj la hispana)
   

   Por RXCUI-uzo:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Por NDC-uzo:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect ankaŭ povas akcepti tekstan ĉenon por petoj pri medikamentaj informoj en la angla, sed vi devas indiki, ke vi serĉas medikamentajn informojn, inkluzivante unu el la du kodaj sistemoj supre listigitaj.
2. Kodo
   Identigu la realan kodon, kiun vi provas serĉi. (Preferata por la angla, Postulata por la hispana)
   mainSearchCriteria.v.c = 637188
3. Droga Nomo
   Identigu la nomon de la drogo per tekstĉeno. (Nedeviga por la angla, Ne uzata por la hispana)
   mainSearchCriteria.v.dn = Parola Tableto Chantix 0,5 MG

Minimume vi devas identigi la kodsistemon kaj la kodon, aŭ la kodsistemon kaj la nomon de la drogo. Sendu ĉiujn tri por plej bonaj rezultoj pri anglaj petoj. Sendu la kodsistemon kaj la kodon por hispanaj petoj.

Laŭvolaj Parametroj

Koda Titolo

Sendante peton pri anglaj informoj, vi povas inkluzivi la laŭvolan parametron de la nomo de la medikamento. Ĉi tio estas detala en la supra sekcio. mainSearchCriteria.v.dn = Parola Tableto Chantix 0,5 MG

Vidu la supran sekcion pri Eligitaj Parametroj por detaloj pri lingvaj kaj eliraj formatoj.

Priskribo de Elektitaj Atom-Elementoj (aŭ JSON-objektoj) en Respondo al Medikamentaj Petoj

Elemento	Priskribo
titolo	Titolo por kongrua paĝo pri medikamento MedlinePlus
ligo	URL por la kongrua paĝo pri medikamento MedlinePlus
aŭtoro	Fonta atribuo por medikamentaj informoj

Ekzemploj de Petoj pri Drogaj Kodoj

Via medikamenta peto devas aspekti kiel unu el la jenaj.

Por peti informojn per RXCUI, via peto devas aspekti jene: 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 = eo

Por peti informojn de NDC por hispanparolanto, via peto devas aspekti jene: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Por sendi tekstan ĉenon sen medikamenta kodo, vi devas identigi vian demandon kiel NDC-tipan peton, tiel ke MedlinePlus Connect scias, ke vi serĉas medikamentajn informojn. Ĉi tio funkcios nur por anglaj petoj. Via peto povus aspekti jene: 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

Petoj pri Informoj pri Laboratoriaj Testoj

MedlinePlus Connect provizas kongruaĵojn al laboratoriaj testaj informoj ricevinte peton pri LOINC. La servo povas doni respondon en la angla aŭ la hispana.

La reteja servo MedlinePlus Connect redonos la jenon:

Eble ne ĉiam ekzistas kongruo por ĉiu kodo. En tiuj kazoj, MedlinePlus Connect redonos nulan respondon.

La baza URL de la servo estas: https://connect.medlineplus.gov/service

Ĉi tiuj estas du bezonataj parametroj por ajna laboratorio-testodemando al ĉi tiu servo:

1. Koda Sistemo
   

   Identigu, ke vi uzas la kodan sistemon LOINC. Uzu:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect ankaŭ akceptos:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kodo
   identigu la realan kodon, kiun vi provas serĉi:
   mainSearchCriteria.v.c = 3187-2

Laŭvolaj Parametroj

Koda Titolo

Vi ankaŭ povas identigi la nomon de la laboratorio. Tamen ĉi tiuj informoj ne efikas sur la respondo. mainSearchCriteria.v.dn = Provo de Faktoro IX

Vidu la supran sekcion pri Eliraj Parametroj por detaloj pri lingvaj kaj eliraj formatoj.

Priskribo de Elektitaj Atom-Elementoj (aŭ JSON-objektoj) en Respondo al Laboratoriotestaj Petoj

Elemento	Priskribo
titolo	Titolo de egala MedlinePlus-laboratorio-paĝo
ligo	URL por kongruita paĝo de laboratorio MedlinePlus
resumo	Fragmento de la paĝa enhavo
aŭtoro	Fonta atribuo por la laboratorio-enhavo

Ekzemploj de Petoj pri Laboratoriaj Testoj

Por peti informojn por anglalingvano, via peto eble aspektas kiel unu el la jenaj: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktoro% 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

Por peti informojn por hispanparolanto, via peto eble aspektas kiel unu el la jenaj: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktoro% 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

Akceptebla Uza Politiko

Por eviti troŝarĝi la servilojn MedlinePlus, NLM postulas, ke uzantoj de MedlinePlus Connect sendu ne pli ol 100 petojn po minuto po IP-adreso. Petoj, kiuj superas ĉi tiun limon, ne servos, kaj servo ne restarigos dum 300 sekundoj aŭ ĝis la petokvanto falos sub la limon, kiom ajn venos poste. Por limigi la nombron de petoj, kiujn vi sendas al Connect, NLM rekomendas konservi rezultojn por 12-24 horoj.

Ĉi tiu politiko funkcias por certigi, ke la servo restu disponebla kaj alirebla por ĉiuj uzantoj. Se vi havas specifan uzokazon, kiu postulas vin sendi multajn petojn al MedlinePlus Connect, kaj tiel superi la limon de petita imposto priskribita en ĉi tiu politiko, bonvolu kontakti nin. NLM-personaro taksos vian peton kaj determinos ĉu escepto povas esti donita. Bonvolu ankaŭ revizii la dokumentaron pri dosieroj MedlinePlus XML. Ĉi tiuj XML-dosieroj enhavas kompletajn sanajn temojn kaj povas servi kiel alternativa metodo por aliri datumojn de MedlinePlus.

Pliaj Informoj