MedlinePlus Connect: Servizz tal-Web

Kontenut

• Ħarsa Ġenerali lejn is-Servizz tal-Web
• Parametri tal-Produzzjoni
• Talbiet għal Kodiċijiet ta 'Dijanjożi (Problema)
• Parametri Fakultattivi
• Deskrizzjoni ta 'Elementi Atom Magħżula (jew oġġetti JSON) f'Risposta għal Talbiet għal Kodiċi ta' Problema
• Eżempji ta 'Talbiet għal Kodiċijiet tal-Problemi
• Servizzi u Fajls Relatati
• Talbiet għal Informazzjoni dwar id-Droga
• Parametri Fakultattivi
• Deskrizzjoni ta 'Elementi ta' Atomi Magħżula (jew oġġetti JSON) f'Risposta għal Talbiet għal Medikazzjoni
• Eżempji ta 'Talbiet għal Kodiċijiet tad-Droga
• Talbiet għal Informazzjoni dwar it-Test tal-Laboratorju
• Parametri Fakultattivi
• Deskrizzjoni ta 'Elementi ta' Atomi Magħżula (jew oġġetti JSON) f'Risposta għal Talbiet għal Test tal-Laboratorju
• Eżempji ta 'Talbiet għal Testijiet tal-Laboratorju
• Politika ta 'Użu Aċċettabbli
• Iktar informazzjoni

MedlinePlus Connect huwa disponibbli bħala applikazzjoni tal-Web jew servizz tal-Web. Hawn taħt jinsabu d-dettalji tekniċi għall-implimentazzjoni tas-servizz tal-Web, li jwieġeb għal talbiet ibbażati fuq:

Int mistieden biex torbot u turi d-dejta mibgħuta lura minn MedlinePlus Connect. Ma tistax tikkopja paġni MedlinePlus fuq is-sit tiegħek. Jekk tuża dejta mis-Servizz tal-Web Connect MedlinePlus, jekk jogħġbok indika li l-informazzjoni hija minn MedlinePlus.gov imma tużax il-logo MedlinePlus jew inkella timplika li MedlinePlus tapprova l-prodott partikolari tiegħek. Jekk jogħġbok ara l-paġna API ta 'NLM għal aktar gwida. Għal aktar informazzjoni dwar kif torbot mal-kontenut ta 'MedlinePlus barra minn dan is-servizz, jekk jogħġbok ara l-linji gwida u l-istruzzjonijiet tagħna dwar il-konnessjoni.

Jekk tiddeċiedi li tuża MedlinePlus Connect, irreġistra għal-lista tal-email biex tlaħħaq mal-iżviluppi u tpartat ideat mal-kollegi tiegħek. Jekk jogħġbok għidilna jekk timplimentax MedlinePlus Connect billi tikkuntattjana.

Ħarsa Ġenerali lejn is-Servizz tal-Web

Il-parametri għat-talbiet tas-servizz tal-Web jikkonformaw mal-Gwida ta ’Implimentazzjoni Ibbażata fuq il-URL dwar it-Talba tal-Għarfien dwar l-Għarfien dwar il-Kuntest-Aware tal-Kuntest HL7 (Infobutton). Ir-rispons ibbażat fuq l-REST jikkonforma mal-Gwida għall-Implimentazzjoni tal-Arkitettura Orjentata lejn is-Servizz Orjentata lejn is-Servizz tal-Kuntest-Konxju (Infobutton) HL7. L-output tat-talba jista 'jkun XML fil-format tal-għalf Atom, JSON, jew JSONP.

L-istruttura tat-talba tindika liema tip ta 'kodiċi qed tibgħat. Fil-każijiet kollha, il-URL bażi għas-servizz tal-Web huwa: https://connect.medlineplus.gov/service

MedlinePlus Connect juża konnessjonijiet HTTPS. Talbiet HTTP ma jiġux aċċettati u l-implimentazzjonijiet eżistenti li jużaw HTTP għandhom jiġu aġġornati għal HTTPS.

Parametri tal-Produzzjoni

Dawn il-parametri mhumiex obbligatorji. Jekk tħallihom barra, ir-risposta awtomatika hija informazzjoni bl-Ingliż f'format XML.

Lingwa
Identifika jekk tixtieqx li r-risposta tkun bl-Ingliż jew bl-Ispanjol. MedlinePlus Connect tassumi li l-Ingliż huwa l-lingwa jekk ma jkunx speċifikat.

Jekk tixtieq li r-risposta għat-tfittxija tal-kodiċi tal-problema tkun bl-Ispanjol, uża: informationRecipient.languageCode.c = es
(= sp aċċettat ukoll)

Biex tispeċifika l-Ingliż, uża dan li ġej: informationRecipient.languageCode.c = en

Format
Identifika jekk tixtieqx li l-format tar-rispons ikun XML, JSON, jew JSONP. XML huwa l-inadempjenza.

Biex titlob JSON, uża:

knowledgeResponseType = applikazzjoni / json

Għal JSONP, uża:

knowledgeResponseType = application / javascript & callback = CallbackFunction fejn CallbackFunction huwa isem li tagħti l-funzjoni ta ’sejħa lura.

Għal tweġiba f'XML, uża:

knowledgeResponseType = test / xml jew ħalli l-parametru knowledgeResponseType barra mit-talba.

Talbiet għal Kodiċijiet ta 'Dijanjożi (Problema)

Għal kodiċi ta 'problema, MedlinePlus Connect tirritorna links u informazzjoni minn paġni ta' suġġett tas-saħħa MedlinePlus, paġni tal-ġenetika, jew paġni minn Istituti NIH oħra.

MedlinePlus Connect tirritorna dan li ġej:

Jista 'jkun li mhux dejjem ikun hemm taqbila għal kull kodiċi. F'dawk il-każijiet, MedlinePlus Connect tirritorna risposta nulla.

Il-URL bażi tas-servizz huwa: https://connect.medlineplus.gov/service

Hemm żewġ parametri meħtieġa għal kwalunkwe mistoqsija dwar dan is-servizz:

1. Sistema tal-Kodiċi
   Identifika s-sistema tal-kodiċi tal-problema li ser tuża.

   Għal użu ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Għall-użu tal-ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Għal użu SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kodiċi
   Identifika l-kodiċi attwali li qed tipprova tfittex:
   mainSearchCriteria.v.c = 250.33

Parametri Fakultattivi

Titolu tal-Kodiċi
Tista 'wkoll tidentifika l-isem / it-titlu tal-kodiċi tal-problema. Madankollu, din l-informazzjoni ma taffettwax ir-rispons (b'differenza mill-applikazzjoni tal-Web MedlinePlus Connect fejn tista 'tintuża l-informazzjoni dwar l-isem / it-titlu). mainSearchCriteria.v.dn = Dijabete mellitus b'koma oħra tat-tip 1 mhux ikkontrollata Ara t-taqsima ta 'hawn fuq dwar il-Parametri tal-Ħruġ għal dettalji dwar il-lingwa u l-formati tal-ħruġ.

Deskrizzjoni ta 'Elementi Atom Magħżula (jew oġġetti JSON) f'Risposta għal Talbiet għal Kodiċi ta' Problema

Element	Nodu tal-klassi	Deskrizzjoni
titolu		Titolu tal-paġna tas-suġġett tas-saħħa MedlinePlus imqabbel jew paġna GHR
rabta		URL għal paġna tas-suġġett tas-saħħa MedlinePlus jew paġna GHR imqabbla
sommarju		Is-sommarju sħiħ għas-suġġett tas-saħħa. Dan jinkludi links inkorporati għal suġġetti relevanti oħra dwar is-saħħa, u l-ifformattjar kollu, inklużi l-balal u l-ispazjar tal-paragrafi. Is-sommarju jinsab f'HTML. Għal paġni GHR, l-ewwel taqsima tal-paġna sħiħa hija pprovduta.
sommarju		Sinonimi għas-suġġett. Dawn jissejħu "Imsejħa wkoll" fuq paġna ta 'suġġett dwar is-saħħa. Mhux is-suġġetti kollha għandhom termini "Imsejħa wkoll".
sommarju		Rikonoxximent ta 'attribuzzjoni għal test sommarju, jekk il-maġġoranza tas-sommarju kien minn aġenzija federali oħra. Mhux is-sommarji kollha għandhom attribuzzjoni. Test mhux attribwit huwa oriġinali għal MedlinePlus.
sommarju		Rabtiet magħżula assoċjati mas-suġġett. Dan jinkludi l-isem tal-paġna, il-URL, u l-organizzazzjoni assoċjata (meta applikabbli). Il-links huma fformattjati f'lista bulleted. Mhux is-suġġetti kollha għandhom dawn il-links. In-numru ta 'links jista' jvarja minn żero għal għexieren.

Eżempji ta 'Talbiet għal Kodiċijiet tal-Problemi

Talba sħiħa għad-Dijabete Mellitus b’koma oħra tat-tip 1 mhux ikkontrollata, kodiċi ICD-9 250.33, għal pazjent li jitkellem bl-Ispanjol ikollu l-indirizz URL li ġej: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Dijabete% 20mellitus% 20b'% 20other% 20coma% 20type% 201% 20unontrolled & informationRecipient.languageCode.c = es

Pazjent bl-istess dijanjosi iżda l-format mitlub huwa JSON u l-lingwa hija l-Ingliż: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Pazjent iddijanjostikat bi "Pnewmonja minħabba Pseudomonas" bl-użu ta 'kodiċi SNOMED CT 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.vc Pnewmonja% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = en

Pazjent bl-istess dijanjosi iżda l-format mitlub huwa 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

Servizzi u Fajls Relatati

Biex tirċievi suġġetti ta 'saħħa MedlinePlus b'reazzjoni għal talbiet ta' test, għall-kuntrarju ta 'kodiċi ta' problemi, tinvestiga s-servizz tal-Web MedlinePlus. Ukoll, jekk għandek bżonn is-sett sħiħ ta 'suġġetti tas-saħħa MedlinePlus f'format XML, ara l-paġna tal-fajls XML tagħna.

Talbiet għal Informazzjoni dwar id-Droga

MedlinePlus Connect jipprovdi l-aħjar logħbiet ta ’informazzjoni dwar id-droga meta tirċievi RXCUI. Jipprovdi wkoll riżultati tajbin meta tirċievi kodiċi NDC. MedlinePlus Connect jista 'jipprovdi tweġibiet bl-Ingliż jew bl-Ispanjol.

Għal talbiet għal informazzjoni dwar il-medikazzjoni Ingliża, jekk ma tibgħatx NDC jew RXCUI jew jekk ma nsibu l-ebda taqbila bbażata fuq il-kodiċi, l-applikazzjoni tuża s-sekwenza tat-test li tibgħat biex turi l-aħjar taqbila ta ’informazzjoni dwar id-droga. Għal talbiet għal informazzjoni dwar il-medikazzjoni Spanjola, MedlinePlus Connect jirrispondi biss għal NDCs jew RXCUIs u ma jużax kordi ta 'test. Huwa possibbli li jkollok risposta bl-Ingliż iżda l-ebda risposta bl-Ispanjol.

Is-servizz tal-Web MedlinePlus Connect jirritorna dan li ġej:

Jista 'jkun hemm tweġibiet multipli għal talba waħda ta' medikazzjoni. Jista 'jkun li mhux dejjem ikun hemm taqbila għal kull talba. F'dawk il-każijiet, MedlinePlus Connect tirritorna risposta nulla.

Għal talbiet għal informazzjoni dwar id-droga, il-URL bażi huwa: https://connect.medlineplus.gov/service

Biex tibgħat talba, inkludi dawn il-biċċiet ta 'informazzjoni:

1. Sistema tal-Kodiċi
   Identifika t-tip ta 'kodiċi tal-medikazzjoni li qed tibgħat. (Meħtieġa għall-Ingliż u l-Ispanjol)
   

   Għall-użu RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Għall-użu NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect jista 'wkoll jaċċetta sekwenza ta' test għal talbiet għal informazzjoni dwar il-medikazzjoni bl-Ingliż, imma trid tindika li qed tfittex informazzjoni dwar il-medikazzjoni billi tinkludi waħda miż-żewġ sistemi ta 'kodiċi elenkati hawn fuq.
2. Kodiċi
   Identifika l-kodiċi attwali li qed tipprova tfittex 'il fuq. (Preferut għall-Ingliż, Meħtieġ għall-Ispanjol)
   mainSearchCriteria.v.c = 637188
3. Isem tad-Droga
   Identifika l-isem tal-mediċina bi spag ta 'test. (Mhux obbligatorju għall-Ingliż, Mhux użat għall-Ispanjol)
   mainSearchCriteria.v.dn = Pillola orali Chantix 0.5 MG

Mill-inqas għandek tidentifika s-sistema tal-kodiċi u l-kodiċi, jew is-sistema tal-kodiċi u l-isem tal-mediċina. Ibgħat it-tlieta għall-aħjar riżultati għal talbiet bl-Ingliż. Ibgħat is-sistema tal-kodiċi u l-kodiċi għat-talbiet Spanjoli.

Parametri Fakultattivi

Titolu tal-Kodiċi

Meta tibgħat talba għal informazzjoni bl-Ingliż, tista 'tinkludi l-parametru mhux obbligatorju ta' l-isem tal-medikazzjoni. Dan huwa ddettaljat fit-taqsima ta 'hawn fuq. mainSearchCriteria.v.dn = Pillola orali Chantix 0.5 MG

Ara t-taqsima ta 'hawn fuq dwar il-Parametri tal-Ħruġ għal dettalji dwar il-lingwa u l-formati tal-ħruġ.

Deskrizzjoni ta 'Elementi ta' Atomi Magħżula (jew oġġetti JSON) f'Risposta għal Talbiet għal Medikazzjoni

Element	Deskrizzjoni
titolu	Titlu għall-paġna tal-medikazzjoni MedlinePlus imqabbla
rabta	URL għall-paġna tal-medikazzjoni MedlinePlus imqabbla
awtur	Attribuzzjoni tas-sors għall-informazzjoni dwar il-medikazzjoni

Eżempji ta 'Talbiet għal Kodiċijiet tad-Droga

It-talba tiegħek għall-informazzjoni dwar il-medikazzjoni għandha tidher qisha waħda minn dawn li ġejjin.

Biex titlob informazzjoni minn RXCUI, it-talba tiegħek għandha tkun hekk: 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 = en

Biex titlob informazzjoni minn NDC għal kelliem Spanjol, it-talba tiegħek għandha tkun hekk: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Biex tibgħat sekwenza ta 'test mingħajr kodiċi ta' medikazzjoni, trid tidentifika l-mistoqsija tiegħek bħala talba tat-tip NDC sabiex MedlinePlus Connect tkun taf li qed tfittex informazzjoni dwar il-medikazzjoni. Dan jaħdem għal talbiet bl-Ingliż biss. It-talba tiegħek tista 'tidher hekk: 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

Talbiet għal Informazzjoni dwar it-Test tal-Laboratorju

MedlinePlus Connect jipprovdi logħbiet għall-informazzjoni tat-test tal-laboratorju meta tirċievi talba LOINC. Is-servizz jista 'jipprovdi tweġiba bl-Ingliż jew bl-Ispanjol.

Is-servizz tal-Web MedlinePlus Connect jirritorna dan li ġej:

Jista 'jkun li mhux dejjem ikun hemm taqbila għal kull kodiċi. F'dawk il-każijiet, MedlinePlus Connect tirritorna risposta nulla.

Il-URL bażi tas-servizz huwa: https://connect.medlineplus.gov/service

Dawn huma żewġ parametri meħtieġa għal kwalunkwe mistoqsija tat-test tal-laboratorju għal dan is-servizz:

1. Sistema tal-Kodiċi
   

   Identifika li qed tuża s-sistema tal-kodiċi LOINC. Uża:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect taċċetta wkoll:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kodiċi
   identifika l-kodiċi attwali li qed tipprova tfittex 'il fuq:
   mainSearchCriteria.v.c = 3187-2

Parametri Fakultattivi

Titolu tal-Kodiċi

Tista 'wkoll tidentifika l-isem tat-test tal-laboratorju. Madankollu, din l-informazzjoni ma taffettwax ir-rispons. mainSearchCriteria.v.dn = Analiżi tal-Fattur IX

Ara t-taqsima ta 'hawn fuq dwar il-Parametri tal-Output għad-dettalji dwar il-lingwa u l-formati tal-output.

Deskrizzjoni ta 'Elementi ta' Atomi Magħżula (jew oġġetti JSON) f'Risposta għal Talbiet għal Test tal-Laboratorju

Element	Deskrizzjoni
titolu	Titlu tal-paġna tat-test tal-laboratorju MedlinePlus imqabbla
rabta	URL għal paġna tat-test tal-laboratorju MedlinePlus imqabbla
sommarju	Snippet mill-kontenut tal-paġna
awtur	Attribuzzjoni tas-sors għall-kontenut tat-test tal-laboratorju

Eżempji ta 'Talbiet għal Testijiet tal-Laboratorju

Biex titlob informazzjoni għal kelliem bl-Ingliż, it-talba tiegħek tista 'tidher bħal waħda minn dawn li ġejjin: 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

Biex titlob informazzjoni għal kelliem Spanjol, it-talba tiegħek tista 'tidher bħal waħda minn dawn li ġejjin: 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

Politika ta 'Użu Aċċettabbli

Sabiex tevita tagħbija żejda fuq is-servers MedlinePlus, NLM teħtieġ li l-utenti ta 'MedlinePlus Connect jibagħtu mhux aktar minn 100 talba kull minuta għal kull indirizz IP. Talbiet li jaqbżu dan il-limitu ma jiġux servis, u s-servizz ma jiġix restawrat għal 300 sekonda jew sakemm ir-rata tat-talba taqa 'taħt il-limitu, liema minnhom tiġi wara. Biex tillimita n-numru ta 'talbiet li tibgħat lil Connect, NLM tirrakkomanda r-riżultati tal-cache għal perjodu ta' 12-24 siegħa.

Din il-politika hija fis-seħħ biex tiżgura li s-servizz jibqa 'disponibbli u aċċessibbli għall-utenti kollha. Jekk għandek każ ta 'użu speċifiku li jeħtieġ li tibgħat numru kbir ta' talbiet lil MedlinePlus Connect, u b'hekk taqbeż il-limitu tar-rata ta 'talba deskritta f'din il-politika, jekk jogħġbok ikkuntattjana. Il-persunal tal-NLM jevalwa t-talba tiegħek u jiddetermina jekk tistax tingħata eċċezzjoni. Jekk jogħġbok irrevedi wkoll id-dokumentazzjoni tal-fajls XML MedlinePlus. Dawn il-fajls XML fihom rekords ta 'suġġetti ta' saħħa kompluti u jistgħu jservu bħala metodu alternattiv ta 'aċċess għad-dejta ta' MedlinePlus.

Iktar informazzjoni