Kuunganisha kwa MedlinePlus: Huduma ya Wavuti

Content.

• Muhtasari wa Huduma ya Wavuti
• Vigezo vya Pato
• Maombi ya Nambari za Utambuzi (Tatizo)
• Vigezo vya hiari
• Maelezo ya Vipengee vya Atomu vilivyochaguliwa (au vitu vya JSON) katika Kujibu Maombi ya Msimbo wa Tatizo
• Mifano ya Maombi ya Nambari za Tatizo
• Huduma zinazohusiana na Faili
• Maombi ya Habari ya Dawa za Kulevya
• Vigezo vya hiari
• Maelezo ya Vipengee vya Atomu vilivyochaguliwa (au vitu vya JSON) katika Kujibu Maombi ya Dawa
• Mifano ya Maombi ya Nambari za Dawa za Kulevya
• Maombi ya Habari ya Mtihani wa Maabara
• Vigezo vya hiari
• Maelezo ya Vipengele vya Atomu vilivyochaguliwa (au vitu vya JSON) katika Kujibu Maombi ya Jaribio la Maabara
• Mifano ya Maombi ya Uchunguzi wa Maabara
• Sera ya Matumizi inayokubalika
• Taarifa zaidi

MedlinePlus Connect inapatikana kama programu ya Wavuti au huduma ya Wavuti. Hapo chini kuna maelezo ya kiufundi ya kutekeleza huduma ya Wavuti, ambayo hujibu maombi kulingana na:

Unakaribishwa kuunganisha na kuonyesha data iliyorudishwa na MedlinePlus Connect.Huwezi kunakili kurasa za MedlinePlus kwenye wavuti yako. Ikiwa unatumia data kutoka kwa Huduma ya Wavuti ya MedlinePlus, tafadhali onyesha kuwa habari hiyo inatoka kwa MedlinePlus.gov lakini usitumie nembo ya MedlinePlus au vinginevyo unamaanisha kuwa MedlinePlus inakubali bidhaa yako. Tafadhali angalia ukurasa wa API ya NLM kwa mwongozo zaidi. Kwa habari zaidi juu ya jinsi ya kuunganisha kwenye yaliyomo ya MedlinePlus nje ya huduma hii, tafadhali angalia miongozo na maagizo yetu juu ya kuunganisha.

Ikiwa unaamua kutumia MedlinePlus Connect, jiandikishe kwa orodha ya barua pepe ili kuendelea na maendeleo na kubadilishana maoni na wenzako. Tafadhali tuambie ikiwa utatumia MedlinePlus Ungana kwa kuwasiliana nasi.

Muhtasari wa Huduma ya Wavuti

Vigezo vya maombi ya huduma ya Wavuti vinaendana na HL7 Context-Aware Knowledge Retrieval (Infobutton) Maarifa Omba Mwongozo wa Utekelezaji wa URL. Jibu linalotegemea REST linaendana na HL7 Context-Aware Knowledge Retrieval (Infobutton) Service-Oriented Architecture Guide. Pato la ombi linaweza kuwa XML katika fomati ya chakula cha Atom, JSON, au JSONP.

Muundo wa ombi unaonyesha ni aina gani ya nambari unayotuma. Katika visa vyote, msingi wa URL ya huduma ya Wavuti ni: https://connect.medlineplus.gov/service

MedlinePlus Connect hutumia unganisho la HTTPS. Maombi ya HTTP hayatakubaliwa na utekelezaji uliopo kwa kutumia HTTP unapaswa kusasisha kuwa HTTPS.

Vigezo vya Pato

Vigezo hivi ni vya hiari. Ukiwaacha, jibu chaguo-msingi ni habari ya Kiingereza katika muundo wa XML.

Lugha
Tambua ikiwa ungependa majibu yawe kwa Kiingereza au Kihispania. MedlinePlus Connect itafikiria Kiingereza ndio lugha ikiwa haijaainishwa.

Ikiwa unataka majibu ya utaftaji wa nambari ya shida kuwa katika Kihispania, tumia: informationRecipient.languageCode.c = es
(= sp pia inakubaliwa)

Kutaja Kiingereza, tumia yafuatayo: informationRecipient.languageCode.c = sw

Umbizo
Tambua ikiwa ungependa fomati ya majibu iwe XML, JSON, au JSONP. XML ni chaguo-msingi.

Kuomba JSON, tumia:

knowledgeResponseType = application / json

Kwa JSONP, tumia:

knowledgeResponseType = application / javascript & callback = CallbackFunction ambapo CallbackFunction ni jina unaloipa kazi ya kupiga simu tena.

Kwa jibu katika XML, tumia:

knowledgeResponseType = text / xml au acha parameter ya knowledgeResponseType nje ya ombi.

Maombi ya Nambari za Utambuzi (Tatizo)

Kwa nambari ya shida, MedlinePlus Connect itarudisha viungo na habari kutoka kwa kurasa za mada ya afya ya MedlinePlus, kurasa za jenetiki, au kurasa kutoka Taasisi zingine za NIH.

MedlinePlus Connect itarudisha yafuatayo:

Kunaweza kuwa hakuna mechi kila nambari. Katika visa hivyo, MedlinePlus Connect itarudisha jibu batili.

URL ya msingi ya huduma ni: https://connect.medlineplus.gov/service

Kuna vigezo viwili vinahitajika kwa swala yoyote kwa huduma hii:

1. Mfumo wa Kanuni
   Tambua mfumo wa nambari za shida utakazotumia.

   Kwa matumizi ya ICD-10-CM:

   Tafutizi kuu ya Utaftaji.v.cs = 2.16.840.1.113883.6.90

   Kwa matumizi ya ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Kwa matumizi ya SNOMED CT:

   Utafutaji kuuCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kanuni
   Tambua nambari halisi unayojaribu kutafuta:
   Utaftaji kuuCriteria.v.c = 250.33

Vigezo vya hiari

Kichwa cha Msimbo
Unaweza pia kutambua jina / jina la nambari ya shida. Walakini, habari hii haiathiri majibu (tofauti na programu ya Mtandao ya MedlinePlus Unganisha ambapo jina / habari ya kichwa inaweza kutumika). mainSearchCriteria.v.dn = Ugonjwa wa kisukari na aina nyingine ya coma 1 isiyodhibitiwa Tazama sehemu iliyo hapo juu juu ya Vigezo vya Pato kwa maelezo juu ya muundo wa lugha na pato.

Maelezo ya Vipengee vya Atomu vilivyochaguliwa (au vitu vya JSON) katika Kujibu Maombi ya Msimbo wa Tatizo

Kipengele	Node ya darasa	Maelezo
kichwa		Kichwa cha ukurasa wa mada ya afya ya MedlinePlus au ukurasa wa GHR
kiungo		URL ya ukurasa wa mada ya afya inayolingana ya MedlinePlus au ukurasa wa GHR
muhtasari		Muhtasari kamili wa mada ya afya. Hii ni pamoja na viungo vilivyopachikwa kwa mada zingine muhimu za kiafya, na muundo wote, pamoja na risasi na nafasi za aya. Muhtasari uko katika HTML. Kwa kurasa za GHR, sehemu ya kwanza ya ukurasa kamili hutolewa.
muhtasari		Visawe vya mada. Hizi zinajulikana kama "Inaitwa pia" kwenye ukurasa wa mada ya afya. Sio mada zote zilizo na masharti ya "Pia huitwa".
muhtasari		Utambuzi wa kielelezo cha maandishi ya muhtasari, ikiwa muhtasari mwingi ulitoka kwa wakala mwingine wa shirikisho. Sio muhtasari wote ulio na sifa. Maandishi yasiyotolewa ni ya asili kwa MedlinePlus.
muhtasari		Viungo vilivyochaguliwa vinavyohusishwa na mada. Hii ni pamoja na jina la ukurasa, URL, na shirika linalohusiana (inapotumika). Viunga vimepangwa katika orodha yenye risasi. Sio mada zote zilizo na viungo hivi. Idadi ya viungo inaweza kuanzia sifuri hadi kadhaa.

Mifano ya Maombi ya Nambari za Tatizo

Ombi kamili la ugonjwa wa kisukari Mellitus na aina nyingine ya coma 1 isiyodhibitiwa, nambari ya ICD-9 250.33, kwa mgonjwa anayezungumza Kihispania atakuwa na anwani ifuatayo ya URL: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Ugonjwa wa kisukari% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20uncontroll & informationRecipient.languageCode.c = es

Mgonjwa aliye na utambuzi sawa lakini fomati iliyoombwa ni JSON na lugha ni Kiingereza: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&nowledgeResponseType=application / json

Mgonjwa aliyegunduliwa na "Pneumonia kwa sababu ya Pseudomonas" akitumia nambari ya SNOMED CT 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonia% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = sw

Mgonjwa aliye na utambuzi sawa lakini fomati iliyoombwa ni JSONP:

Huduma zinazohusiana na Faili

Kupokea mada ya afya ya MedlinePlus kwa kujibu maombi ya maandishi, tofauti na nambari za shida, chunguza huduma ya Wavuti ya MedlinePlus. Pia, ikiwa unahitaji seti kamili ya mada ya afya ya MedlinePlus katika muundo wa XML, angalia ukurasa wetu wa faili za XML.

Maombi ya Habari ya Dawa za Kulevya

MedlinePlus Connect hutoa habari bora za dawa wakati wa kupokea RXCUI. Pia hutoa matokeo mazuri wakati wa kupokea nambari ya NDC. MedlinePlus Connect inaweza kutoa majibu kwa Kiingereza au Kihispania.

Kwa maombi ya habari ya dawa ya Kiingereza, ikiwa hautatuma NDC au RXCUI au ikiwa hatutapata mechi kulingana na nambari, programu itatumia kamba ya maandishi ambayo unatuma kuonyesha mechi bora ya habari ya dawa. Kwa maombi ya habari ya dawa ya Uhispania, MedlinePlus Connect hujibu tu kwa NDCs au RXCUIs na haitumii masharti ya maandishi. Inawezekana kuwa na majibu kwa Kiingereza lakini hakuna jibu kwa Kihispania.

Huduma ya Wavuti ya MedlinePlus Unganisha zifuatazo:

Kunaweza kuwa na majibu mengi kwa ombi moja la dawa. Kunaweza kuwa hakuna mechi kila wakati kwa kila ombi. Katika visa hivyo, MedlinePlus Connect itarudisha jibu batili.

Kwa maombi ya habari ya dawa za kulevya, URL ya msingi ni: https://connect.medlineplus.gov/service

Ili kutuma ombi, jumuisha habari hizi:

1. Mfumo wa Kanuni
   Tambua aina ya nambari ya dawa unayotuma. (Inahitajika kwa Kiingereza na Kihispania)
   

   Kwa matumizi ya RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Kwa matumizi ya NDC:

   Utafutaji kuuCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect pia inaweza kukubali kamba ya maandishi ya ombi la habari ya dawa kwa Kiingereza, lakini lazima uonyeshe unatafuta habari ya dawa kwa kujumuisha moja ya mifumo miwili ya nambari zilizoorodheshwa hapo juu.
2. Kanuni
   Tambua nambari halisi ambayo unajaribu kutafuta. (Inapendelewa kwa Kiingereza, Inahitajika kwa Uhispania)
   Njia kuu ya Utaftaji.v.c = 637188
3. Jina la Dawa ya Kulevya
   Tambua jina la dawa hiyo na kamba ya maandishi. (Hiari kwa Kiingereza, Haitumiwi kwa Kihispania)
   mainSearchCriteria.v.dn = Chantix 0.5 MG Ubao Mdomo

Kwa kiwango cha chini unapaswa kutambua mfumo wa nambari na nambari, au mfumo wa nambari na jina la dawa. Tuma zote tatu kwa matokeo bora ya maombi ya Kiingereza. Tuma mfumo wa nambari na nambari ya maombi ya Uhispania.

Vigezo vya hiari

Kichwa cha Msimbo

Wakati wa kutuma ombi la habari ya Kiingereza, unaweza kujumuisha parameter ya hiari ya jina la dawa. Hii ni ya kina katika sehemu iliyo hapo juu. mainSearchCriteria.v.dn = Chantix 0.5 MG Ubao Mdomo

Tazama sehemu iliyo hapo juu juu ya Vigezo vya Pato kwa maelezo juu ya muundo wa lugha na pato.

Maelezo ya Vipengee vya Atomu vilivyochaguliwa (au vitu vya JSON) katika Kujibu Maombi ya Dawa

Kipengele	Maelezo
kichwa	Kichwa cha ukurasa wa dawa unaolingana wa MedlinePlus
kiungo	URL ya ukurasa wa dawa unaolingana wa MedlinePlus
mwandishi	Utoaji wa chanzo kwa habari ya dawa

Mifano ya Maombi ya Nambari za Dawa za Kulevya

Ombi lako la habari ya dawa linapaswa kuonekana kama moja ya yafuatayo.

Kuomba habari na RXCUI, ombi lako linapaswa kuonekana kama hii: 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% 20Tabati na habari Mpokeaji.languageCode.c = sw

Kuomba habari kutoka kwa NDC kwa spika ya Uhispania, ombi lako linapaswa kuonekana kama hii: 39 & habari Mpokeaji.LanguageCode.c = es

Ili kutuma kamba ya maandishi bila nambari ya dawa, lazima utambue swala lako kama ombi la aina ya NDC ili MedlinePlus Connect ifahamu kuwa unatafuta habari ya dawa. Hii itafanya kazi kwa maombi ya Kiingereza tu. Ombi lako linaweza kuonekana kama hii: 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.canguage. = sw

Maombi ya Habari ya Mtihani wa Maabara

MedlinePlus Connect hutoa mechi kwa habari ya mtihani wa maabara wakati wa kupokea ombi la LOINC. Huduma inaweza kutoa jibu kwa Kiingereza au Kihispania.

Huduma ya Wavuti ya MedlinePlus Unganisha itafuata zifuatazo:

Kunaweza kuwa hakuna mechi kila nambari. Katika visa hivyo, MedlinePlus Connect itarudisha jibu batili.

URL ya msingi ya huduma ni: https://connect.medlineplus.gov/service

Hizi ni vigezo viwili vinavyohitajika kwa swala yoyote ya jaribio la maabara kwa huduma hii:

1. Mfumo wa Kanuni
   

   Tambua kuwa unatumia mfumo wa kificho wa LOINC. Tumia:

   Utafutaji kuuCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect pia itakubali:

   Utafutaji kuuCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kanuni
   tambua nambari halisi unayojaribu kutafuta:
   Sera kuu ya Utaftaji.v.c = 3187-2

Vigezo vya hiari

Kichwa cha Msimbo

Unaweza pia kutambua jina la jaribio la maabara. Walakini, habari hii haiathiri majibu. mainSearchCriteria.v.dn = Kiwango cha majaribio ya IX

Tazama sehemu iliyo hapo juu juu ya Vigezo vya Pato kwa maelezo juu ya muundo wa lugha na pato.

Maelezo ya Vipengele vya Atomu vilivyochaguliwa (au vitu vya JSON) katika Kujibu Maombi ya Jaribio la Maabara

Kipengele	Maelezo
kichwa	Kichwa cha ukurasa wa mtihani wa maabara wa MedlinePlus unaolingana
kiungo	URL ya ukurasa wa mtihani wa maabara wa MedlinePlus unaolingana
muhtasari	Kijisehemu kutoka kwa yaliyomo kwenye ukurasa
mwandishi	Utoaji wa chanzo kwa yaliyomo kwenye jaribio la maabara

Mifano ya Maombi ya Uchunguzi wa Maabara

Kuomba habari kwa spika wa Kiingereza, ombi lako linaweza kuonekana kama moja ya yafuatayo: 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 = sw https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.cl. = sw

Kuomba habari kwa spika ya Uhispania, ombi lako linaweza kuonekana kama moja ya yafuatayo: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Sababu% 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 Language = es

Sera ya Matumizi inayokubalika

Ili kuzuia kupakia zaidi seva za MedlinePlus, NLM inahitaji watumiaji wa MedlinePlus Connect wasitume maombi zaidi ya 100 kwa dakika kwa anwani ya IP. Maombi ambayo yanazidi kikomo hiki hayatahudumiwa, na huduma haitarejeshwa kwa sekunde 300 au mpaka kiwango cha ombi kianguke chini ya kikomo, yoyote itakayokuja baadaye. Ili kupunguza idadi ya maombi ambayo unatuma kwa Unganisha, NLM inapendekeza matokeo ya akiba kwa muda wa saa 12-24.

Sera hii imewekwa ili kuhakikisha kuwa huduma hiyo inabaki kupatikana na kupatikana kwa watumiaji wote. Ikiwa una kesi maalum ya matumizi ambayo inahitaji upeleke idadi kubwa ya maombi kwa MedlinePlus Connect, na kwa hivyo uzidi kiwango cha kiwango cha ombi kilichoainishwa katika sera hii, tafadhali wasiliana nasi. Wafanyikazi wa NLM watatathmini ombi lako na kuamua ikiwa ubaguzi unaweza kutolewa. Tafadhali pia pitia hati za faili za MedlinePlus XML. Faili hizi za XML zina kumbukumbu kamili za mada ya afya na zinaweza kutumika kama njia mbadala ya kufikia data ya MedlinePlus.

Taarifa zaidi