„MedlinePlus Connect“: žiniatinklio paslauga

Turinys

• Žiniatinklio paslaugos apžvalga
• Išvesties parametrai
• Prašymai nustatyti diagnozės (problemos) kodus
• Neprivalomi parametrai
• Pasirinktų „Atom“ elementų (arba JSON objektų) aprašymas atsakant į problemos kodo užklausas
• Užklausų dėl problemų kodų pavyzdžiai
• Susijusios paslaugos ir bylos
• Prašymai pateikti informacijos apie vaistus
• Neprivalomi parametrai
• Pasirinktų atominių elementų (arba JSON objektų) aprašymas atsakant į vaistų užklausas
• Prašymų pateikti narkotikų kodus pavyzdžiai
• Prašymai pateikti informaciją apie laboratorinius tyrimus
• Neprivalomi parametrai
• Pasirinktų atomo elementų (arba JSON objektų) aprašymas atsakant į laboratorinių bandymų užklausas
• Prašymų atlikti laboratorinius tyrimus pavyzdžiai
• Priimtino naudojimo politika
• Daugiau informacijos

„MedlinePlus Connect“ galima įsigyti kaip žiniatinklio programą arba žiniatinklio paslaugą. Toliau pateikiama techninė informacija, kaip įdiegti žiniatinklio paslaugą, kuri atsako į užklausas pagal:

Kviečiame susieti ir rodyti „MedlinePlus Connect“ grąžintus duomenis. Jūs negalite nukopijuoti „MedlinePlus“ puslapių į savo svetainę. Jei naudojate „MedlinePlus Connect“ žiniatinklio tarnybos duomenis, nurodykite, kad informacija yra iš „MedlinePlus.gov“, tačiau nenaudokite „MedlinePlus“ logotipo arba kitaip nurodykite, kad „MedlinePlus“ pritaria jūsų konkrečiam produktui. Norėdami sužinoti daugiau, žr. NLM API puslapį. Norėdami gauti daugiau informacijos apie tai, kaip susieti su „MedlinePlus“ turiniu už šios paslaugos ribų, žiūrėkite mūsų susiejimo gaires ir instrukcijas.

Jei nuspręsite naudoti „MedlinePlus Connect“, prisiregistruokite gauti el. Pašto sąrašą, kad neatsiliktumėte nuo pokyčių ir keistumėtės idėjomis su savo kolegomis. Susisiekite su mumis, jei įdiegiate „MedlinePlus Connect“.

Žiniatinklio paslaugos apžvalga

Žiniatinklio paslaugų užklausų parametrai atitinka HL7 konteksto žinojimo žinių paieškos (informacijos mygtuko) žinių užklausos URL pagrįsto diegimo vadovą. „REST“ pagrįstas atsakymas atitinka „HL7 Context-Aware Knowledge Retrieval (Infobutton)“ į paslaugas orientuoto architektūros diegimo vadovą. Užklausos išvestis gali būti XML „Atom“ sklaidos kanalo formatu, JSON arba JSONP.

Užklausos struktūra nurodo, kokio tipo kodą siunčiate. Visais atvejais pagrindinis žiniatinklio paslaugos URL yra: https://connect.medlineplus.gov/service

„MedlinePlus Connect“ naudoja HTTPS ryšius. HTTP užklausos nebus priimamos, o esami diegimai, naudojant HTTP, turėtų būti atnaujinti į HTTPS.

Išvesties parametrai

Šie parametrai yra neprivalomi. Jei jų nepaliksite, numatytasis atsakymas yra XML formato informacija anglų kalba.

Kalba
Nurodykite, ar norite, kad atsakymas būtų pateiktas anglų ar ispanų kalbomis. „MedlinePlus Connect“ laikys, kad anglų kalba yra kalba, jei ji nėra nurodyta.

Jei norite, kad atsakymas į problemos kodo paiešką būtų pateiktas ispanų kalba, naudokite: informationRecipient.languageCode.c = es
(= taip pat priimtas sp)

Jei norite nurodyti anglų kalbą, naudokite: informationRecipient.languageCode.c = lt

Formatas
Nurodykite, ar norite, kad atsakymo formatas būtų XML, JSON ar JSONP. XML yra numatytasis.

Norėdami paprašyti JSON, naudokite:

žiniųResponseType = programa / json

JSONP naudokite:

knowledgeResponseType = application / javascript & callback = CallbackFunction, kai CallbackFunction yra vardas, kurį suteikiate atgalinio skambinimo funkcija.

Norėdami gauti atsakymą XML, naudokite:

žiniųResponseType = text / xml arba palikite parametrą knowResponseType užklausoje.

Prašymai nustatyti diagnozės (problemos) kodus

Norėdami gauti problemos kodą, „MedlinePlus Connect“ grąžins nuorodas ir informaciją iš „MedlinePlus“ sveikatos temų puslapių, genetikos puslapių ar kitų NIH institutų puslapių.

„MedlinePlus Connect“ pateiks:

Ne visada kiekvienas kodas gali atitikti. Tokiais atvejais „MedlinePlus Connect“ pateiks niekinį atsakymą.

Pagrindinis paslaugos URL yra: https://connect.medlineplus.gov/service

Bet kuriai šios paslaugos užklausai reikalingi du parametrai:

1. Kodo sistema
   Nurodykite problemos kodo sistemą, kurią naudosite.

   Naudojant TLK-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Naudojant TLK-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Naudojant SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kodas
   Nurodykite tikrąjį kodą, kurio bandote ieškoti:
   mainSearchCriteria.v.c = 250.33

Neprivalomi parametrai

Kodo pavadinimas
Taip pat galite nustatyti problemos kodo pavadinimą / pavadinimą. Tačiau ši informacija neturi įtakos atsakymui (skirtingai nei „MedlinePlus Connect“ žiniatinklio programa, kurioje gali būti naudojama vardo / pavadinimo informacija). mainSearchCriteria.v.dn = Cukrinis diabetas su kitu 1 tipo koma nekontroliuojama. Išsamesnės informacijos apie kalbą ir išvesties formatus rasite aukščiau esančiame skyriuje Išvesties parametrai

Pasirinktų „Atom“ elementų (arba JSON objektų) aprašymas atsakant į problemos kodo užklausas

Elementas	Klasės mazgas	apibūdinimas
pavadinimas		Atitinkamo „MedlinePlus“ sveikatos temos puslapio arba GHR puslapio pavadinimas
nuoroda		Atitinkamo „MedlinePlus“ sveikatos temos puslapio arba GHR puslapio URL
santrauka		Visa sveikatos temos santrauka. Tai apima įterptąsias nuorodas į kitas svarbias sveikatos temas ir visą formatavimą, įskaitant ženklelius ir tarpų tarp pastraipų. Santrauka yra HTML. GHR puslapiams pateikiamas pirmasis viso puslapio skyrius.
santrauka		Temos sinonimai. Sveikatos temos puslapyje jie vadinami „Taip pat vadinami“. Ne visose temose yra terminai „Taip pat vadinami“.
santrauka		Santraukos teksto priskyrimo patvirtinimas, jei didžioji dalis santraukos buvo iš kitos federalinės agentūros. Ne visos santraukos turi priskyrimą. Nepriskirtas tekstas yra „MedlinePlus“ originalas.
santrauka		Pasirinktos nuorodos, susijusios su tema. Tai apima puslapio pavadinimą, URL ir susietą organizaciją (kai taikoma). Nuorodos suformatuotos sąraše su ženkleliais. Ne visos temos turi šias nuorodas. Nuorodų skaičius gali svyruoti nuo nulio iki dešimčių.

Užklausų dėl problemų kodų pavyzdžiai

Visiškas ispanakalbio paciento prašymas dėl cukrinio diabeto su kitu nekontroliuojamu 1 tipo koma, TLK-9 kodu 250,33, turėtų šį URL adresą: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = cukrinis diabetas% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20controlated & informationRecipient.languageCode.c = es

Pacientas su ta pačia diagnoze, bet prašomas formatas yra JSON, o kalba yra anglų: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / Json

Pacientas, kuriam diagnozuota „Pneumonija dėl Pseudomonas“, naudojant SNOMED CT kodą 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonija% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = lt

Pacientas, turintis tą pačią diagnozę, tačiau prašomas formatas yra JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=

Susijusios paslaugos ir bylos

Norėdami gauti „MedlinePlus“ sveikatos temas atsakydami į teksto užklausas, o ne į problemų kodus, ištirkite „MedlinePlus“ žiniatinklio paslaugą. Be to, jei jums reikia viso „MedlinePlus“ sveikatos temų rinkinio XML formatu, peržiūrėkite mūsų XML failų puslapį.

Prašymai pateikti informacijos apie vaistus

Gavę RXCUI, „MedlinePlus Connect“ pateikia geriausias informacijos apie narkotikus atitikmenis. Tai taip pat suteikia gerų rezultatų gaunant NDC kodą. „MedlinePlus Connect“ gali pateikti atsakymus anglų arba ispanų kalbomis.

Jei norite gauti informacijos apie vaistus anglų kalba, jei nesiunčiate NDC ar RXCUI arba jei nerandame atitikties pagal kodą, programa naudos jūsų siųstą teksto eilutę, kad būtų rodomos geriausios informacijos apie vaistus. Jei norite gauti informacijos apie ispanų vaistus, „MedlinePlus Connect“ atsako tik į NDC ar RXCUI ir nenaudoja tekstinių eilučių. Galima atsakyti angliškai, bet atsakyti ispaniškai negalima.

„MedlinePlus Connect“ žiniatinklio tarnyba grąžins:

Gali būti keli atsakymai į vieną vaistų prašymą. Ne visada kiekviena užklausa gali atitikti. Tokiais atvejais „MedlinePlus Connect“ pateiks niekinį atsakymą.

Jei norite gauti informacijos apie narkotikus, pagrindinis URL yra: https://connect.medlineplus.gov/service

Norėdami išsiųsti užklausą, įtraukite šią informaciją:

1. Kodo sistema
   Nurodykite siunčiamo vaisto kodo tipą. (Būtina anglų ir ispanų kalboms)
   

   Naudojant RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Naudojant NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   „MedlinePlus Connect“ taip pat gali priimti teksto eilutę užklausoms dėl informacijos apie vaistus anglų kalba, tačiau turite nurodyti, kad ieškote informacijos apie vaistus, įtraukdami vieną iš dviejų aukščiau išvardytų kodų sistemų.
2. Kodas
   Nurodykite tikrąjį kodą, kurio bandote ieškoti. (Pageidaujama anglų kalba, būtina ispanų kalba)
   mainSearchCriteria.v.c = 637188
3. Vaisto pavadinimas
   Nurodykite vaisto pavadinimą teksto eilute. (Neprivaloma anglų kalba, nenaudojama ispanų kalbai)
   mainSearchCriteria.v.dn = „Chantix“ 0,5 mg geriamoji tabletė

Turėtumėte identifikuoti bent kodo sistemą ir kodą, arba kodų sistemą ir vaisto pavadinimą. Norėdami gauti geriausius rezultatus, jei norite gauti anglų kalbos užklausas, siųskite visus tris. Atsiųskite kodų sistemą ir ispaniškų užklausų kodą.

Neprivalomi parametrai

Kodo pavadinimas

Siųsdami užklausą dėl informacijos anglų kalba, galite įtraukti pasirinktinį vaisto pavadinimo parametrą. Tai išsamiai aprašyta ankstesniame skyriuje. mainSearchCriteria.v.dn = „Chantix“ 0,5 mg geriamoji tabletė

Išsamesnę informaciją apie kalbą ir išvesties formatus rasite aukščiau esančiame skyriuje „Išvesties parametrai“.

Pasirinktų atominių elementų (arba JSON objektų) aprašymas atsakant į vaistų užklausas

Elementas	apibūdinimas
pavadinimas	Atitikusio „MedlinePlus“ vaistų puslapio pavadinimas
nuoroda	Atitikusio „MedlinePlus“ vaistų puslapio URL
autorius	Šaltinio priskyrimas informacijai apie vaistus

Prašymų pateikti narkotikų kodus pavyzdžiai

Jūsų vaistų informacijos užklausa turėtų atrodyti kaip viena iš šių.

Norėdami paprašyti informacijos per RXCUI, jūsų užklausa turėtų atrodyti taip: 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 = lt

Norėdami paprašyti informacijos iš NDC apie ispanų kalbėtoją, jūsų prašymas turėtų atrodyti taip: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Norėdami išsiųsti teksto eilutę be vaistų kodo, turite nurodyti savo užklausą kaip NDC tipo užklausą, kad „MedlinePlus Connect“ žinotų, kad ieškote informacijos apie vaistus. Tai veiks tik angliškoms užklausoms. Jūsų užklausa gali atrodyti taip: 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 = lt

Prašymai pateikti informaciją apie laboratorinius tyrimus

„MedlinePlus Connect“ pateikia laboratorinių tyrimų informacijos atitikmenis, kai gauna LOINC užklausą. Paslauga gali pateikti atsakymą anglų arba ispanų kalbomis.

„MedlinePlus Connect“ žiniatinklio tarnyba grąžins:

Ne visada kiekvienas kodas gali atitikti. Tokiais atvejais „MedlinePlus Connect“ pateiks niekinį atsakymą.

Pagrindinis paslaugos URL yra: https://connect.medlineplus.gov/service

Tai yra du būtini bet kurios šios paslaugos laboratorinių tyrimų užklausos parametrai:

1. Kodo sistema
   

   Nustatykite, kad naudojate LOINC kodų sistemą. Naudokite:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   „MedlinePlus Connect“ taip pat priims:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kodas
   nustatykite faktinį kodą, kurio bandote ieškoti:
   mainSearchCriteria.v.c = 3187-2

Neprivalomi parametrai

Kodo pavadinimas

Taip pat galite nustatyti laboratorinio tyrimo pavadinimą. Tačiau ši informacija neturi įtakos atsakymui. mainSearchCriteria.v.dn = IX faktoriaus tyrimas

Išsamesnę informaciją apie kalbą ir išvesties formatus rasite aukščiau esančiame skyriuje „Išvesties parametrai“.

Pasirinktų atomo elementų (arba JSON objektų) aprašymas atsakant į laboratorinių bandymų užklausas

Elementas	apibūdinimas
pavadinimas	Atitinkamo „MedlinePlus“ laboratorinio tyrimo puslapio pavadinimas
nuoroda	Atitikusio „MedlinePlus“ laboratorinio tyrimo puslapio URL
santrauka	Ištrauka iš puslapio turinio
autorius	Laboratorinio tyrimo turinio šaltinio priskyrimas

Prašymų atlikti laboratorinius tyrimus pavyzdžiai

Jei norite paprašyti informacijos angliškai kalbančiam asmeniui, jūsų užklausa gali atrodyti viena iš šių: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = faktorius% 20IX% 20assay & informationRecipient.languageCode.c = lt https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language = lt

Jei norite paprašyti informacijos ispanų kalba, jūsų užklausa gali atrodyti kaip viena iš šių: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = faktorius% 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.language = es

Priimtino naudojimo politika

Norint išvengti „MedlinePlus“ serverių perkrovos, NLM reikalauja, kad „MedlinePlus Connect“ vartotojai siunčia ne daugiau kaip 100 užklausų per minutę vienam IP adresui. Užklausos, viršijančios šią ribą, nebus aptarnaujamos ir aptarnavimas nebus atkurtas 300 sekundžių arba kol užklausų rodiklis nesieks ribos, atsižvelgiant į tai, kas įvyks vėliau. Norėdami apriboti užklausų, kurias siunčiate į „Connect“, skaičių, NLM rekomenduoja 12–24 valandų laikotarpio talpyklos rezultatus.

Ši politika taikoma siekiant užtikrinti, kad paslauga išliktų prieinama ir prieinama visiems vartotojams. Jei turite konkretų naudojimo atvejį, dėl kurio jums reikia siųsti daug užklausų „MedlinePlus Connect“ ir tokiu būdu viršyti šioje politikoje nurodytą užklausų normos limitą, susisiekite su mumis. NLM darbuotojai įvertins jūsų prašymą ir nustatys, ar gali būti suteikta išimtis. Taip pat peržiūrėkite „MedlinePlus XML“ failų dokumentus. Šiuose XML failuose yra visi sveikatos temos įrašai ir jie gali būti alternatyvus būdas pasiekti „MedlinePlus“ duomenis.

Daugiau informacijos