MedlinePlus Connect: Webapplikasjon
![What is MedlinePlus and How do I use it?](https://i.ytimg.com/vi/B-TmBC0XtiY/hqdefault.jpg)
Innhold
- Oversikt over webapplikasjoner
- Forespørsler om diagnosekoder
- Valgfrie parametere
- Eksempler på forespørsler om problemkoder
- Forespørsler om legemiddelinformasjon
- Valgfrie parametere
- Eksempler på forespørsler om legemiddelkoder
- Forespørsler om laboratorietestinformasjon
- Valgfrie parametere
- 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 webapplikasjonen, som svarer på forespørsler basert på:
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. Du er velkommen til å lenke til og vise data levert av MedlinePlus Connect. For mer informasjon om hvordan du kobler til MedlinePlus-innhold utenfor denne tjenesten, se våre retningslinjer og instruksjoner om lenking.
Oversikt over webapplikasjoner
API for nettapplikasjonen er i samsvar med HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation specification. Strukturen på forespørselen indikerer hvilken type kode du sender. I alle tilfeller er nettadressen til nettapplikasjonen: https://connect.medlineplus.gov/application
MedlinePlus Connect bruker HTTPS-tilkoblinger. HTTP-forespørsler blir ikke godtatt, og eksisterende implementeringer som bruker HTTP, bør oppdateres til HTTPS.
Forespørsler om diagnosekoder
MedlinePlus Connect samsvarer med ICD-10-CM, ICD-9-CM eller SNOMED CT-koder til relaterte MedlinePlus helsesidesider, genetiske sider eller sider fra andre NIH-institutter. For eksempel kan en pasient diagnostisert med ICD-9-CM-kode 493.12, Ekstrinsisk astma med forverring, bli presentert en lenke i en elektronisk helseregistrering (EHR) som fører til MedlinePlus-siden Astma.
For forespørsler etter problem er basis-URL-en til applikasjonen: https://connect.medlineplus.gov/applicationDenne lenken viser en side med et tomt søkefelt. Det er to nødvendige parametere for alle spørsmål til dette programmet:
- 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
- Identifiser den faktiske koden du prøver å slå opp:
mainSearchCriteria.v.c = 250.33
Valgfrie parametere
Identifiser navnet / tittelen på problemkoden. Å sende ingen kode vil resultere i et spørsmål til MedlinePlus-søkemotoren. Hvis du spesifiserer en kode og navnet / tittelen på koden, men MedlinePlus Connect ikke har noen resultater, vil svarssiden vise et MedlinePlus-søkefelt forhåndsutfylt med navnet / tittelen. mainSearchCriteria.v.dn = Diabetes mellitus med annen koma type 1 ukontrollert
Identifiser om du vil at forespørselen 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
Eksempler på forespørsler om problemkoder
En fullstendig forespørsel om diabetes mellitus med annen koma 1 ukontrollert, ICD-9-kode 250.33, for en spansktalende pasient vil ha følgende URL-adresse: https://connect.medlineplus.gov/application?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 diagnostisert med "lungebetennelse på grunn av Pseudomonas" ved hjelp av SNOMED CT-kode 41381004: https://connect.medlineplus.gov/application?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
Et spørreskjema uten kodesystem eller problemkode, vil bruke MedlinePlus-søkemotoren (kun engelsk): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
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å medisinskodeforespørsler på engelsk eller spansk, og vil returnere en lenke til en resultatside med de beste kampene fra medisininformasjonen fra MedlinePlus.
For forespørsler om engelsk medisininformasjon, hvis du ikke sender en NDC- eller RXCUI-kode, eller hvis vi ikke finner noen samsvar basert på koden, vil vi bruke tekststrengen du sender for å vise den beste legemiddelinformasjonsmatchen. For forespørsler om spansk medisininformasjon, svarer MedlinePlus Connect bare på NDC eller RXCUI; den bruker ikke tekststrenger. Det er mulig å ha svar på engelsk, men ikke svar på spansk.
Det kan være flere svar på en medisinforespørsel. Det kan ikke alltid være samsvar for hver forespørsel. Hvis MedlinePlus Connect finner et nullrespons for en medisinforespørsel, viser programmet en søkeboks for MedlinePlus-nettstedet. En bruker kan skrive inn et legemiddelnavn og kan få god respons.
For forespørsler om legemiddelinformasjon er basis-URL: https://connect.medlineplus.gov/application
Forespørsler om engelsk og spansk medisininformasjon har forskjellige krav. For å sende en forespørsel, inkluder disse informasjonene:
- 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
- Identifiser den faktiske koden du prøver å slå opp. (Foretrukket for engelsk, påkrevd for spansk)
mainSearchCriteria.v.c = 637188 - Identifiser navnet på stoffet med en tekststreng. (Valgfritt for engelsk, ikke brukt for spansk)
mainSearchCriteria.v.dn = Chantix 0,5 mg oral tablett
For engelske forespørsler, bør du som minimum identifisere kodesystemet og koden, eller kodesystemet og navnet på stoffet. Send alle tre for best resultat for engelske forespørsler. For spanske forespørsler, bør du identifisere kodesystemet og koden.
Valgfrie parametere
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. Denne parameteren brukes ikke til spanske forespørsler.
Identifiser om du vil at forespørselen 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å medisineringskoden skal være på spansk, kan du bruke: informationRecipient.languageCode.c = es (= sp også akseptert)
For å spesifisere engelsk, bruk følgende: informationRecipient.languageCode.c = no
Eksempler på forespørsler om legemiddelkoder
Din legemiddelinformasjonsforespørsel bør 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/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=%20637188%20&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/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.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 engelsk. Forespørselen din kan se slik ut: https://connect.medlineplus.gov/application?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. MedlinePlus Connect kan gi svar på laboratorietestforespørsler på engelsk eller spansk, og vil returnere en lenke til en resultatside med de beste treffene fra MedlinePlus-testinformasjonen.
For forespørsler om laboratorietestinformasjon er basis-URL: https://connect.medlineplus.gov/application
Dette er to nødvendige parametere for ethvert laboratorietestespørsmål til dette programmet:
- Identifiser at du bruker LOINC-kodesystemet.
- For LOINC 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
- Identifiser den faktiske koden du prøver å slå opp.
mainSearchCriteria.v.c = 3187-2
Valgfrie parametere
Identifiser navnet / tittelen på laboratorietesten. Denne informasjonen påvirker imidlertid ikke svaret. mainSearchCriteria.v.dn = Faktor IX-analyse
Identifiser om du vil at forespørselen 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 godtas også)
For å spesifisere engelsk, bruk følgende: informationRecipient.languageCode.c = no
En freeform-spørring, uten kodesystem eller labkode, vil bruke MedlinePlus-søkemotoren. Denne tilnærmingen er mer effektiv med diagnoser (se informasjon om problemkoden ovenfor) i stedet for tekststrenger for laboratorietester. Informasjonsforespørselen din om laboratorietest skal se ut som en av følgende.
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/application?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/application?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/application?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/application?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.