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:
- 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
- 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:
- 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
- Kode
Identifiser den faktiske koden du prøver å slå opp. (Foretrukket for engelsk, påkrevd for spansk)
mainSearchCriteria.v.c = 637188 - Legemiddelnavn
Identifiser navnet på stoffet med en tekststreng. (Valgfritt for engelsk, ikke brukt for spansk)
mainSearchCriteria.v.dn = Chantix 0,5 mg oral tablett
Valgfrie parametere
KodetittelNå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:
- 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
- Kode
identifiser den faktiske koden du prøver å slå opp:
mainSearchCriteria.v.c = 3187-2
Valgfrie parametere
KodetittelDu 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
Våre Publikasjoner
Spør treneren: Vekter