MedlinePlus Connect: Webtjeneste

Innhold

• Oversikt over nettjenesten
• Utgangsparametere
• Forespørsler om diagnosekoder
• Valgfrie parametere
• Beskrivelse av valgte atomelementer (eller JSON-objekter) som svar på forespørsler om problemkoder
• Eksempler på forespørsler om problemkoder
• Relaterte tjenester og filer
• Forespørsler om legemiddelinformasjon
• Valgfrie parametere
• Beskrivelse av utvalgte atomelementer (eller JSON-objekter) som svar på medisineringsanmodninger
• Eksempler på forespørsler om legemiddelkoder
• Forespørsler om laboratorietestinformasjon
• Valgfrie parametere
• Beskrivelse av valgte atomelementer (eller JSON-objekter) som svar på laboratorietestforespørsler
• Eksempler på forespørsler om laboratorietester
• Retningslinjer for akseptabel bruk
• Mer informasjon

MedlinePlus Connect er tilgjengelig som et webapplikasjon eller en nettjeneste. Nedenfor er de tekniske detaljene for implementering av nettjenesten, som svarer på forespørsler basert på:

Du er velkommen til å lenke til og vise dataene som returneres av MedlinePlus Connect. Du kan ikke kopiere MedlinePlus-sider til nettstedet ditt. Hvis du bruker data fra MedlinePlus Connect Web Service, må du oppgi at informasjonen er fra MedlinePlus.gov, men ikke bruke MedlinePlus-logoen eller på annen måte antyde at MedlinePlus støtter ditt spesifikke produkt. Se NLMs API-side for ytterligere veiledning. For mer informasjon om hvordan du kobler til MedlinePlus-innhold utenfor denne tjenesten, se våre retningslinjer og instruksjoner om lenking.

Hvis du bestemmer deg for å bruke MedlinePlus Connect, kan du registrere deg for e-postlisten for å holde deg oppdatert og utvikle ideer med kollegene dine. Fortell oss om du implementerer MedlinePlus Connect ved å kontakte oss.

Oversikt over nettjenesten

Parametrene for webserviceforespørslene samsvarer med HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation Guide. Det REST-baserte svaret er i samsvar med HL7 Context-Aware Knowledge Retrieval (Infobutton) Service-Oriented Architecture Implementation Guide. Utdataene fra forespørselen kan være XML i Atom-feedformat, JSON eller JSONP.

Strukturen på forespørselen indikerer hvilken type kode du sender. I alle tilfeller er nettadressen til nettjenesten: https://connect.medlineplus.gov/service

MedlinePlus Connect bruker HTTPS-tilkoblinger. HTTP-forespørsler blir ikke godtatt, og eksisterende implementeringer som bruker HTTP, bør oppdateres til HTTPS.

Utgangsparametere

Disse parametrene er valgfrie. Hvis du utelater dem, er standardrespons engelsk informasjon i XML-format.

Språk
Identifiser om du vil at svaret skal være på engelsk eller spansk. MedlinePlus Connect antar at engelsk er språket hvis det ikke er spesifisert.

Hvis du ønsker at svaret på problemkoden skal være på spansk, kan du bruke: informationRecipient.languageCode.c = es
(= sp aksepteres også)

For å spesifisere engelsk, bruk følgende: informationRecipient.languageCode.c = no

Format
Identifiser om du vil at svarformatet skal være XML, JSON eller JSONP. XML er standard.

For å be om JSON, bruk:

knowledgeResponseType = applikasjon / json

For JSONP, bruk:

knowledgeResponseType = application / javascript & callback = CallbackFunction der CallbackFunction er et navn du gir tilbakekallingsfunksjonen.

For svar i XML, bruk:

knowledgeResponseType = text / xml eller la parameteren KnowledgeResponseType være utenfor forespørselen.

Forespørsler om diagnosekoder

For en problemkode vil MedlinePlus Connect returnere lenker og informasjon fra MedlinePlus helsesidesider, genetiske sider eller sider fra andre NIH-institutter.

MedlinePlus Connect vil returnere følgende:

Det kan ikke alltid være samsvar for hver kode. I slike tilfeller vil MedlinePlus Connect returnere null svar.

Basis-URL-en til tjenesten er: https://connect.medlineplus.gov/service

Det er to nødvendige parametere for alle spørsmål til denne tjenesten:

1. Kodesystem
   Identifiser problemkodesystemet du skal bruke.

   For ICD-10-CM bruk:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   For bruk av ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   For bruk av SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kode
   Identifiser den faktiske koden du prøver å slå opp:
   mainSearchCriteria.v.c = 250.33

Valgfrie parametere

Kodetittel
Du kan også identifisere navnet / tittelen på problemkoden. Denne informasjonen påvirker imidlertid ikke responsen (i motsetning til MedlinePlus Connect-webapplikasjonen der navnet / tittelinformasjonen kan brukes). mainSearchCriteria.v.dn = Diabetes mellitus med annen koma type 1 ukontrollert Se avsnittet ovenfor om Output Parameters for detaljer om språk og outputformater.

Beskrivelse av valgte atomelementer (eller JSON-objekter) som svar på forespørsler om problemkoder

Element	Klasseknute	Beskrivelse
tittel		Tittel på samsvarende MedlinePlus-helsesideside eller GHR-side
lenke		URL for samsvarende MedlinePlus-helsesideside eller GHR-side
sammendrag		Hele sammendraget for helseemnet. Dette inkluderer innebygde lenker til andre relevante helseemner, og all formatering, inkludert kuler og avsnittavstand. Sammendraget er i HTML. For GHR-sider er den første delen av hele siden gitt.
sammendrag		Synonymer for emnet. Disse blir referert til som "Også kalt" på en helsetema-side. Ikke alle emner har "Også kalt" termer.
sammendrag		Attribusjonsbekreftelse for sammendragstekst, hvis flertallet av sammendraget var fra et annet føderalt byrå. Ikke alle sammendrag har en henvisning. Utilskrevet tekst er original til MedlinePlus.
sammendrag		Utvalgte lenker knyttet til emnet. Dette inkluderer sidenavnet, URL og tilknyttet organisasjon (når det er aktuelt). Koblingene er formatert i en punktliste. Ikke alle emner har disse koblingene. Antall lenker kan variere fra null til dusinvis.

Eksempler på forespørsler om problemkoder

En fullstendig forespørsel om diabetes mellitus med annen koma type 1 ukontrollert, ICD-9-kode 250.33, for en spansktalende pasient vil ha følgende URL-adresse: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabetes% 20mellitus% 20med% 20other% 20coma% 20type% 201% 20 ukontrollert & informationRecipient.languageCode.c = es

En pasient med samme diagnose men ønsket format er JSON og språket er engelsk: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

En pasient diagnostisert med "lungebetennelse på grunn av Pseudomonas" ved bruk av SNOMED CT-kode 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Lungebetennelse% 20forfall% 20til% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = no

En pasient med samme diagnose men ønsket format er JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFallback

Relaterte tjenester og filer

For å motta MedlinePlus helseemner som svar på tekstforespørsler, i motsetning til problemkoder, må du undersøke MedlinePlus-nettjenesten. Hvis du trenger hele settet med MedlinePlus helseemner i XML-format, kan du se siden XML-filer.

Forespørsler om legemiddelinformasjon

MedlinePlus Connect gir de beste legemiddelinformasjonskampene når du mottar en RXCUI. Det gir også gode resultater når du mottar en NDC-kode. MedlinePlus Connect kan gi svar på engelsk eller spansk.

For forespørsler om engelsk medisininformasjon, hvis du ikke sender en NDC eller RXCUI, eller hvis vi ikke finner noen samsvar basert på koden, vil applikasjonen bruke tekststrengen du sender til å vise den beste legemiddelinformasjonsmatchen. For forespørsler om spansk medisineringsinformasjon, svarer MedlinePlus Connect bare på NDC eller RXCUI og bruker ikke tekststrenger. Det er mulig å ha et svar på engelsk, men ikke noe svar på spansk.

MedlinePlus Connect-nettjenesten vil returnere følgende:

Det kan være flere svar på en medisinforespørsel. Det kan ikke alltid være samsvar for hver forespørsel. I slike tilfeller vil MedlinePlus Connect returnere null svar.

For forespørsler om legemiddelinformasjon er basis-URL: https://connect.medlineplus.gov/service

For å sende en forespørsel, inkluder disse informasjonene:

1. Kodesystem
   Identifiser typen medisineringskode du sender. (Påkrevd for engelsk og spansk)
   

   For RXCUI bruk:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   For NDC bruk:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect kan også godta en tekststreng for forespørsler om medisininformasjon på engelsk, men du må indikere at du leter etter medisininformasjon ved å inkludere et av de to kodesystemene som er oppført ovenfor.
2. Kode
   Identifiser den faktiske koden du prøver å slå opp. (Foretrukket for engelsk, påkrevd for spansk)
   mainSearchCriteria.v.c = 637188
3. Legemiddelnavn
   Identifiser navnet på stoffet med en tekststreng. (Valgfritt for engelsk, ikke brukt for spansk)
   mainSearchCriteria.v.dn = Chantix 0,5 mg oral tablett

I det minste bør du identifisere kodesystemet og koden, eller kodesystemet og navnet på stoffet. Send alle tre for best resultat for engelske forespørsler. Send kodesystemet og koden for spanske forespørsler.

Valgfrie parametere

Kodetittel

Når du sender en forespørsel om engelsk informasjon, kan du inkludere den valgfrie parameteren for medisinens navn. Dette er beskrevet i avsnittet ovenfor. mainSearchCriteria.v.dn = Chantix 0,5 mg oral tablett

Se avsnittet ovenfor om utdata-parametere for detaljer om språk og utdataformater.

Beskrivelse av utvalgte atomelementer (eller JSON-objekter) som svar på medisineringsanmodninger

Element	Beskrivelse
tittel	Tittel for samsvarende MedlinePlus medisineringsside
lenke	URL for samsvarende MedlinePlus medisinering side
forfatter	Kildetildeling for medisininformasjon

Eksempler på forespørsler om legemiddelkoder

Din medisininformasjonsforespørsel skal se ut som en av følgende.

For å be om informasjon fra en RXCUI, bør forespørselen din se slik ut: 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% 20 Oral% 20Tablet & informationRecipient.languageCode.c = no

For å be om informasjon fra en NDC for en spansk høyttaler, bør forespørselen din se slik ut: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informasjonRecipient.languageCode.c = es

For å sende en tekststreng uten medisineringskode, må du identifisere spørringen som en NDC-type forespørsel, slik at MedlinePlus Connect vet at du leter etter medisininformasjon. Dette fungerer bare for engelske forespørsler. Forespørselen din kan se slik ut: 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 = no

Forespørsler om laboratorietestinformasjon

MedlinePlus Connect gir samsvar med laboratorietestinformasjon når du mottar en LOINC-forespørsel. Tjenesten kan gi svar på engelsk eller spansk.

MedlinePlus Connect-nettjenesten vil returnere følgende:

Det kan ikke alltid være samsvar for hver kode. I slike tilfeller vil MedlinePlus Connect returnere null svar.

Basis-URL-en til tjenesten er: https://connect.medlineplus.gov/service

Dette er to nødvendige parametere for ethvert laboratorietestespørsmål til denne tjenesten:

1. Kodesystem
   

   Identifiser at du bruker LOINC-kodesystemet. Bruk:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect godtar også:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kode
   identifiser den faktiske koden du prøver å slå opp:
   mainSearchCriteria.v.c = 3187-2

Valgfrie parametere

Kodetittel

Du kan også identifisere navnet på laboratorietesten. Denne informasjonen påvirker imidlertid ikke svaret. mainSearchCriteria.v.dn = Faktor IX-analyse

Se avsnittet ovenfor om utdata-parametere for detaljer om språk og utdataformater.

Beskrivelse av valgte atomelementer (eller JSON-objekter) som svar på laboratorietestforespørsler

Element	Beskrivelse
tittel	Tittel på matchet MedlinePlus lab testside
lenke	URL for samsvarende MedlinePlus-testside
sammendrag	Utdrag fra sideinnholdet
forfatter	Kildetildeling for innholdet i laboratorietesten

Eksempler på forespørsler om laboratorietester

For å be om informasjon for en engelsktalende kan forespørselen din se ut som en av følgende: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 20IX% 20assay & informationRecipient.languageCode.c = no https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = no

For å be om informasjon for en spansk høyttaler kan forespørselen din se ut som en av følgende: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 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

Retningslinjer for akseptabel bruk

For å unngå overbelastning av MedlinePlus-serverne, krever NLM at brukere av MedlinePlus Connect ikke sender mer enn 100 forespørsler per minutt per IP-adresse. Forespørsler som overskrider denne grensen, blir ikke behandlet, og tjenesten vil ikke bli gjenopprettet i 300 sekunder eller før forespørselsfrekvensen faller under grensen, avhengig av hva som kommer senere. For å begrense antall forespørsler du sender til Connect, anbefaler NLM bufreresultater i en periode på 12-24 timer.

Denne policyen er på plass for å sikre at tjenesten forblir tilgjengelig og tilgjengelig for alle brukere. Hvis du har en spesifikk brukssak som krever at du sender et stort antall forespørsler til MedlinePlus Connect, og dermed overskrider forespørselsgrensen som er beskrevet i denne policyen, kan du kontakte oss. NLM-ansatte vil vurdere forespørselen din og avgjøre om unntak kan gis. Les også dokumentasjonen for MedlinePlus XML-filer. Disse XML-filene inneholder komplette poster for helseemner og kan fungere som en alternativ metode for tilgang til MedlinePlus-data.

Mer informasjon