MedlinePlus Connect: veebiteenus

Sisu

• Veebiteenuse ülevaade
• Väljundi parameetrid
• Diagnoosi (probleem) koodide taotlused
• Valikulised parameetrid
• Valitud aatomielementide (või JSON-objektide) kirjeldus vastusena probleemikoodi taotlustele
• Näited probleemikoodide taotlustest
• Seotud teenused ja failid
• Uimastiteabe taotlused
• Valikulised parameetrid
• Valitud aatomielementide (või JSON-objektide) kirjeldus vastusena ravimitaotlustele
• Ravimikoodide taotluste näited
• Lab-testide teabe taotlused
• Valikulised parameetrid
• Valitud aatomielementide (või JSON-objektide) kirjeldus vastusena labori testitaotlustele
• Laborikatsete taotluste näited
• Vastuvõetava kasutamise eeskirjad
• Rohkem informatsiooni

MedlinePlus Connect on saadaval veebirakenduse või veebiteenusena. Allpool on toodud veebiteenuse juurutamise tehnilised üksikasjad, mis vastavad päringutele:

Olete oodatud linkima ja kuvama MedlinePlus Connecti tagastatud andmeid. Te ei tohi MedlinePlus'i lehti oma saidile kopeerida. Kui kasutate MedlinePlus Connect veebiteenuse andmeid, palun märkige, et teave pärineb MedlinePlus.gov-ist, kuid ärge kasutage MedlinePlus'i logo või vihjake muul viisil, et MedlinePlus toetab teie konkreetset toodet. Lisateavet leiate NLM-i API-lehelt. Lisateavet selle kohta, kuidas linkida MedlinePlusi sisuga väljaspool seda teenust, vaadake meie linkimisjuhiseid ja juhiseid.

Kui otsustate kasutada MedlinePlus Connecti, registreeruge e-posti loendis, et kursis olla arengutega ja kolleegidega ideid vahetada. Palun öelge meile, kui kasutate MedlinePlus Connecti, võtke meiega ühendust.

Veebiteenuse ülevaade

Veebiteenuse taotluste parameetrid vastavad HL7 kontekstiteadliku teadmiste otsimise (infonupp) teadmistetaotluse URL-põhisele juurutusjuhendile. REST-põhine vastus vastab HL7 Context-Aware Knowledge Retrieval (Infobutton) teenusele orienteeritud arhitektuuri juurutusjuhendile. Taotluse väljund võib olla XML Atom-voo vormingus, JSON või JSONP.

Taotluse struktuur näitab, millist tüüpi koodi saadate. Kõigil juhtudel on veebiteenuse põhi-URL: https://connect.medlineplus.gov/service

MedlinePlus Connect kasutab HTTPS-ühendusi. HTTP-päringuid ei aktsepteerita ja olemasolevad HTTP-rakendused peaksid värskendama HTTPS-i.

Väljundi parameetrid

Need parameetrid on valikulised. Kui jätate need välja, on vaikevastus XML-vormingus ingliskeelne teave.

Keel
Tehke kindlaks, kas soovite, et vastus oleks inglise või hispaania keeles. MedlinePlus Connect eeldab, et keel on inglise keel, kui seda pole täpsustatud.

Kui soovite, et probleemkoodi otsingu vastus oleks hispaania keel, kasutage: informationRecipient.languageCode.c = es
(= aktsepteeritud ka sp)

Inglise keele määramiseks kasutage järgmist: informationRecipient.languageCode.c = et

Vormindus
Tehke kindlaks, kas soovite, et vastuse vorming oleks XML, JSON või JSONP. XML on vaikimisi.

JSON-i taotlemiseks kasutage:

knowledgeResponseType = rakendus / json

JSONP-i jaoks kasutage:

knowledgeResponseType = application / javascript & callback = CallbackFunction kus CallbackFunction on nimi, mille annate tagasihelistamisfunktsioonile.

XML-is vastuse saamiseks kasutage järgmist:

knowledgeResponseType = text / xml või jätke parameeter knowledgeResponseType päringust välja.

Diagnoosi (probleem) koodide taotlused

Probleemkoodi saamiseks tagastab MedlinePlus Connect lingid ja teabe MedlinePlusi terviseteemade lehtedelt, geneetika lehtedelt või teiste NIH-i instituutide lehtedelt.

MedlinePlus Connect tagastab järgmise:

Iga koodi jaoks ei pruugi alati sobida. Sellistel juhtudel tagastab MedlinePlus Connect tühi vastus.

Teenuse põhi-URL on: https://connect.medlineplus.gov/service

Selle teenuse mis tahes päringu jaoks on kaks nõutavat parameetrit:

1. Koodisüsteem
   Tuvastage kasutatav probleemkoodide süsteem.

   ICD-10-CM kasutamiseks:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   ICD-9-CM kasutamiseks:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   SNOMED CT kasutamiseks:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kood
   Tuvastage tegelik kood, mida proovite otsida.
   mainSearchCriteria.v.c = 250,33

Valikulised parameetrid

Koodi pealkiri
Samuti võite tuvastada probleemikoodi nime / pealkirja. See teave ei mõjuta vastust (erinevalt veebirakendusest MedlinePlus Connect, kus võidakse kasutada nime / pealkirja teavet). mainSearchCriteria.v.dn = Diabetes mellitus koos muu 1. tüüpi koomaga kontrollimatu. Vaadake ülaltoodud jaotist väljundparameetrite kohta keele ja väljundvormingute kohta.

Valitud aatomielementide (või JSON-objektide) kirjeldus vastusena probleemikoodi taotlustele

Element	Klassi sõlm	Kirjeldus
pealkiri		Sobitatud MedlinePlusi terviseteemalise lehe või GHR-i lehe pealkiri
link		Sobitatud MedlinePlusi terviseteemalise lehe või GHR-i lehe URL
kokkuvõte		Tervise teema täielik kokkuvõte. See hõlmab manustatud linke muudele asjakohastele terviseteemadele ja kõiki vorminguid, sealhulgas täppe ja lõikudevahet. Kokkuvõte on HTML-is. GHR-lehtede jaoks on ette nähtud kogu lehe esimene jaotis.
kokkuvõte		Teema sünonüümid. Tervisetemaatika lehel nimetatakse neid ka "nimetatakse". Kõigil teemadel ei ole termineid "nimetatakse ka".
kokkuvõte		Kokkuvõtte teksti omistamise kinnitus, kui enamus kokkuvõttest pärineb mõnelt teiselt föderaalselt agentuurilt. Kõigil kokkuvõtetel pole omistust. Omistamata tekst on MedlinePlusile originaalne.
kokkuvõte		Teemaga seotud valitud lingid. See hõlmab lehe nime, URL-i ja seotud organisatsiooni (kui see on asjakohane). Lingid vormindatakse täppidega loendis. Kõigil teemadel pole neid linke. Linkide arv võib ulatuda nullist kümneteni.

Näited probleemikoodide taotlustest

Diabetes Mellituse täielikul taotlusel koos teise 1. tüüpi kooma kontrollimatu ICD-9 koodiga 250.33 hispaania keelt kõneleva patsiendi jaoks oleks järgmine URL-aadress: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabeet% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20ontrollimatu & informationRecipient.languageCode.c = es

Sama diagnoosiga, kuid taotletud vormingus patsient on JSON ja keel on inglise keeles: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Patsiendil, kellel diagnoositi SNOMED CT koodi 41381004 kasutades "Pseudomonasest põhjustatud kopsupõletik": https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumoonia% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = et

Sama diagnoosiga, kuid taotletud vormingus patsient on JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=

Seotud teenused ja failid

MedlinePlusi terviseteemade saamiseks vastuseks tekstitaotlustele, mitte probleemikoodidele, uurige veebiteenust MedlinePlus. Samuti, kui vajate kogu MedlinePlusi terviseteemade komplekti XML-vormingus, vaadake meie XML-failide lehte.

Uimastiteabe taotlused

MedlinePlus Connect pakub RXCUI saamisel parimaid ravimiteabe vasteid. See annab häid tulemusi ka NDC-koodi saamisel. MedlinePlus Connect võib anda vastuseid inglise või hispaania keeles.

Inglise ravimiteabe taotluste korral, kui te ei saada NDC või RXCUI või kui me ei leia koodi põhjal vastet, kasutab rakendus teie saadetud tekstistringi, et kuvada parim ravimiteabe vaste. Hispaania ravimiteabe taotluste korral vastab MedlinePlus Connect ainult NDC-dele või RXCUI-dele ega kasuta tekstistringi. On võimalik saada vastus inglise keeles, kuid hispaania keeles vastust ei saa.

MedlinePlus Connect veebiteenus tagastab järgmise:

Ühele ravimitaotlusele võib olla mitu vastust. Iga päringu jaoks ei pruugi alati sobida. Sellistel juhtudel tagastab MedlinePlus Connect tühja vastuse.

Uimastiteabe taotluste puhul on põhi-URL: https://connect.medlineplus.gov/service

Taotluse saatmiseks lisage järgmised andmed:

1. Koodisüsteem
   Tuvastage saadetava ravimikoodi tüüp. (Nõutav inglise ja hispaania keeles)
   

   RXCUI kasutamiseks:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   NDC kasutamiseks:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect võtab vastu ka ingliskeelse ravimiteabe taotluste tekstistringi, kuid peate märkima, et otsite ravimiteavet, lisades ühe kahest eespool loetletud koodisüsteemist.
2. Kood
   Tuvastage tegelik kood, mida proovite otsida. (Eelistatud inglise keeles, kohustuslik hispaania keeles)
   mainSearchCriteria.v.c = 637188
3. Ravimi nimi
   Nimetage ravimi nimi tekstistringiga. (Valikuline inglise keeles, ei kasutata hispaania keeles)
   mainSearchCriteria.v.dn = Chantix 0,5 MG suukaudne tablett

Vähemalt peaksite tuvastama koodisüsteemi ja koodi või koodisüsteemi ja ravimi nimetuse. Parimate tulemuste saamiseks ingliskeelsete taotluste korral saatke kõik kolm. Saatke koodisüsteem ja Hispaania päringute kood.

Valikulised parameetrid

Koodi pealkiri

Ingliskeelse teabe päringu saatmisel võite lisada ravimi nime valikulise parameetri. Seda on üksikasjalikult kirjeldatud ülaltoodud jaotises. mainSearchCriteria.v.dn = Chantix 0,5 MG suukaudne tablett

Vaadake ülaltoodud jaotist väljundparameetrite kohta keele ja väljundvormingute üksikasjade kohta.

Valitud aatomielementide (või JSON-objektide) kirjeldus vastusena ravimitaotlustele

Element	Kirjeldus
pealkiri	MedlinePlusi sobitatud ravimilehe pealkiri
link	Sobitatud MedlinePlusi ravimilehe URL
autor	Ravimiteabe allika omistamine

Ravimikoodide taotluste näited

Teie ravimiteabe taotlus peaks välja nägema üks järgmistest.

RXCUI-lt teabe küsimiseks peaks teie päring välja nägema järgmiselt: 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 ja teaveRecipient.languageCode.c = et

NDC poolt hispaania keelt kõneleja jaoks teabe küsimiseks peaks teie taotlus olema järgmine: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Raviskoodita tekstistringi saatmiseks peate oma päringu tuvastama NDC-tüüpi päringuna, nii et MedlinePlus Connect teab, et otsite teavet ravimi kohta. See töötab ainult ingliskeelsete taotluste korral. Teie taotlus võib välja näha järgmine: 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 = et

Lab-testide teabe taotlused

MedlinePlus Connect pakub LOINC-päringu saamisel vasteid laborikatse teabele. Teenus võib anda vastuse inglise või hispaania keeles.

MedlinePlus Connect veebiteenus tagastab järgmise:

Iga koodi jaoks ei pruugi alati sobida. Sellistel juhtudel tagastab MedlinePlus Connect tühja vastuse.

Teenuse põhi-URL on: https://connect.medlineplus.gov/service

Need on kaks selle teenuse laborikatse päringu jaoks nõutavat parameetrit:

1. Koodisüsteem
   

   Tuvastage, et kasutate LOINC-koodisüsteemi. Kasutage:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect aktsepteerib ka:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kood
   tuvastage tegelik kood, mida proovite otsida:
   mainSearchCriteria.v.c = 3187-2

Valikulised parameetrid

Koodi pealkiri

Samuti võite tuvastada labori testi nime. See teave ei mõjuta reageerimist. mainSearchCriteria.v.dn = IX faktori analüüs

Vaadake ülaltoodud jaotist väljundparameetrite kohta keele ja väljundvormingute üksikasjade kohta.

Valitud aatomielementide (või JSON-objektide) kirjeldus vastusena labori testitaotlustele

Element	Kirjeldus
pealkiri	Sobitatud MedlinePlus laboritesti lehe pealkiri
link	Sobitatud MedlinePlus labori testlehe URL
kokkuvõte	Katkend lehe sisust
autor	Labori testi sisu allika omistamine

Laborikatsete taotluste näited

Ingliskeelse kõneleja teabe küsimiseks võib teie päring välja näha üks järgmistest: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = tegur% 20IX% 20assay & informationRecipient.languageCode.c = et https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language = et

Hispaania keelt kõneleja jaoks teabe küsimiseks võib teie päring välja näha üks järgmistest: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = tegur% 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

Vastuvõetava kasutamise eeskirjad

MedlinePlus-serverite ülekoormamise vältimiseks nõuab NLM, et MedlinePlus Connecti kasutajad saadaksid IP-aadressi kohta mitte rohkem kui 100 taotlust minutis. Seda limiiti ületavaid taotlusi ei teenita ja teenuseid ei taastata 300 sekundi jooksul või enne, kui taotluste määr jääb limiidi alla, olenevalt sellest, kumb saabub hiljem. Connectile saadetud taotluste arvu piiramiseks soovitab NLM vahemällu salvestamise tulemusi 12–24-tunniseks perioodiks.

See reegel on loodud tagamaks, et teenus jääb kõigile kasutajatele kättesaadavaks ja kättesaadavaks. Kui teil on konkreetne kasutusjuhtum, mille tõttu peate MedlinePlus Connectile saatma palju taotlusi ja seega ületama käesolevas eeskirjas sätestatud taotluste määra piiri, võtke meiega ühendust. NLM-i töötajad hindavad teie taotlust ja teevad kindlaks, kas võib lubada erandit. Palun vaadake üle ka MedlinePlus XML-failide dokumentatsioon. Need XML-failid sisaldavad täielikke terviseteemalisi kirjeid ja neid saab kasutada alternatiivse meetodina MedlinePlusi andmetele juurde pääsemiseks.

Rohkem informatsiooni