MedlinePlus Connect: webbapplikation
Innehåll
- Översikt över webbapplikationer
- Begäran om diagnos (problemkoder)
- Valfria parametrar
- Exempel på förfrågningar om problemkoder
- Begäran om läkemedelsinformation
- Valfria parametrar
- Exempel på begäranden om läkemedelskoder
- Begäran om labtestinformation
- Valfria parametrar
- Exempel på begäran om laboratorietester
- Policy för godtagbar användning
- Mer information
MedlinePlus Connect finns som webbapplikation eller webbtjänst. Nedan finns de tekniska detaljerna för implementering av webbapplikationen, som svarar på förfrågningar baserade på:
Om du väljer att använda MedlinePlus Connect kan du registrera dig för e-postlistan för att hålla koll på utvecklingen och utbyta idéer med dina kollegor. Berätta om du implementerar MedlinePlus Connect genom att kontakta oss. Du är välkommen att länka till och visa de uppgifter som tillhandahålls av MedlinePlus Connect. För mer information om hur du länkar till MedlinePlus-innehåll utanför denna tjänst, se våra riktlinjer och instruktioner om länkning.
Översikt över webbapplikationer
API för webbapplikationen överensstämmer med HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation specification. Förfråganens struktur anger vilken typ av kod du skickar. I alla fall är webbadressen för webbapplikationen: https://connect.medlineplus.gov/application
MedlinePlus Connect använder HTTPS-anslutningar. HTTP-förfrågningar accepteras inte och befintliga implementeringar som använder HTTP bör uppdateras till HTTPS.
Begäran om diagnos (problemkoder)
MedlinePlus Connect matchar ICD-10-CM, ICD-9-CM eller SNOMED CT-koder till relaterade MedlinePlus-hälsotemasidor, genetiska sidor eller sidor från andra NIH-institut. Till exempel kan en patient som diagnostiserats med ICD-9-CM-kod 493.12, Extrinsic astma with exacerbation, presenteras en länk i en elektronisk patientjournal (EHR) som leder till MedlinePlus-sidan Astma.
För problemförfrågningar är programmets bas-URL: https://connect.medlineplus.gov/applicationDen här länken visar en sida med en tom sökruta. Det finns två parametrar som krävs för alla frågor till den här applikationen:
- Identifiera det problemkodsystem du ska använda.
- För ICD-10-CM användning:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- För ICD-9-CM användning:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- För SNOMED CT-användning:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Identifiera den faktiska koden som du försöker slå upp:
mainSearchCriteria.v.c = 250.33
Valfria parametrar
Identifiera namnet / titeln på problemkoden. Att skicka ingen kod resulterar i en fråga till MedlinePlus-sökmotorn. Om du anger en kod och namnet / titeln på koden, men MedlinePlus Connect inte har några resultat, kommer svarsidan att visa en MedlinePlus-sökruta förfyllt med namn / titel. mainSearchCriteria.v.dn = Diabetes mellitus med annan koma typ 1 okontrollerad
Identifiera om du vill att begäran ska vara på engelska eller spanska. MedlinePlus Connect antar att engelska är språket om det inte anges.
Om du vill att svaret på problemkodsuppslaget ska vara på spanska, använd: informationRecipient.languageCode.c = es
(= sp accepteras också)
För att specificera engelska, använd följande: informationRecipient.languageCode.c = sv
Exempel på förfrågningar om problemkoder
En fullständig begäran om diabetes mellitus med annan okontrollerad koma 1-ICD-9-kod 250.33 för en spansktalande patient skulle ha följande URL-adress: 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 20 20typ% 201% 20 okontrollerad & informationRecipient.languageCode.c = es
En patient diagnostiserad med "lunginflammation på grund av Pseudomonas" med SNOMED CT-kod 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Lunginflammation% 20 förfall% 20 till% 20 Pseudomonas% 20% 28 störning% 29 & informationRecipient.languageCode.c = sv
En frågeformfråga, utan kodsystem eller problemkod, kommer att använda MedlinePlus-sökmotorn (endast engelska): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
Begäran om läkemedelsinformation
MedlinePlus Connect ger de bästa läkemedelsinformationsmatcherna när du får en RXCUI. Det ger också bra resultat när du tar emot en NDC-kod. MedlinePlus Connect kan ge svar på medicinska kodförfrågningar på engelska eller spanska och kommer att returnera en länk till en resultatsida med de bästa matchningarna från läkemedelsinformationen från MedlinePlus.
För förfrågningar om engelsk medicininformation, om du inte skickar en NDC- eller RXCUI-kod eller om vi inte hittar någon matchning baserat på koden, använder vi textsträngen som du skickar för att visa den bästa läkemedelsinformationsmatchningen. För förfrågningar om spansk medicineringsinformation svarar MedlinePlus Connect endast på NDC eller RXCUI; den använder inte textsträngar. Det är möjligt att ha ett svar på engelska men inget svar på spanska.
Det kan finnas flera svar på en medicinförfrågan. Det kan inte alltid finnas en matchning för varje begäran. Om MedlinePlus Connect hittar ett nollsvar för en läkemedelsförfrågan, visar programmet en sökruta för MedlinePlus-webbplatsen. En användare kan skriva in ett läkemedelsnamn och kan få ett bra svar.
För förfrågningar om läkemedelsinformation är basadressen: https://connect.medlineplus.gov/application
Förfrågningar om engelsk och spansk medicininformation har olika krav. För att skicka en begäran, inkludera följande information:
- Identifiera vilken typ av medicineringskod du skickar. (Krävs för engelska och spanska)
- För RXCUI-användning:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- För NDC-användning:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Identifiera den faktiska koden du försöker slå upp. (Föredras för engelska, krävs för spanska)
mainSearchCriteria.v.c = 637188 - Identifiera läkemedlets namn med en textsträng. (Valfritt för engelska, används inte för spanska)
mainSearchCriteria.v.dn = Chantix 0,5 mg oral tablett
För engelska förfrågningar bör du minst identifiera kodsystemet och koden eller kodsystemet och läkemedlets namn. Skicka alla tre för bästa resultat för engelska förfrågningar. För spanska förfrågningar bör du identifiera kodsystemet och koden.
Valfria parametrar
När du skickar en begäran om engelsk information kan du inkludera den valfria parametern för läkemedlets namn. Detta beskrivs i avsnittet ovan. Denna parameter används inte för spanska förfrågningar.
Identifiera om du vill att begäran ska vara på engelska eller spanska. MedlinePlus Connect antar att engelska är språket om det inte anges.
Om du vill att svaret på medicineringskoden ska vara på spanska, använd: informationRecipient.languageCode.c = es (= sp accepteras också)
För att specificera engelska, använd följande: informationRecipient.languageCode.c = sv
Exempel på begäranden om läkemedelskoder
Din läkemedelsinformationsförfrågan ska se ut som något av följande.
För att begära information från en RXCUI bör din förfrågan se ut så här: 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 = sv
För att begära information från en NDC för en spansktalande ska din begäran se ut så här: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.languageCode.c = es
För att skicka en textsträng utan medicineringskod måste du identifiera din fråga som en NDC-typförfrågan så att MedlinePlus Connect vet att du letar efter medicininformation. Detta fungerar endast för engelska. Din förfrågan kan se ut så här: 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 = sv
Begäran om labtestinformation
MedlinePlus Connect tillhandahåller matchningar med laboratorietestinformation när du får en LOINC-begäran. MedlinePlus Connect kan ge svar på labtestförfrågningar på engelska eller spanska och kommer att returnera en länk till en resultatsida med de bästa matchningarna från MedlinePlus labtestinformation.
För förfrågningar om laboratorietestinformation är basadressen: https://connect.medlineplus.gov/application
Dessa är två nödvändiga parametrar för alla laboratorietestfrågor till denna applikation:
- Identifiera att du använder LOINC-kodsystemet.
- För LOINC-användning:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect accepterar också:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Identifiera den faktiska koden du försöker slå upp.
mainSearchCriteria.v.c = 3187-2
Valfria parametrar
Identifiera namnet / titeln på laboratorietestet. Denna information påverkar dock inte svaret. mainSearchCriteria.v.dn = Faktor IX-analys
Identifiera om du vill att begäran ska vara på engelska eller spanska. MedlinePlus Connect antar att engelska är språket om det inte anges.
Om du vill att svaret på problemkodsöversikten ska vara på spanska, använd: informationRecipient.languageCode.c = es (= sp accepteras också)
För att specificera engelska, använd följande: informationRecipient.languageCode.c = sv
En freeform-fråga, utan kodsystem eller labkod, kommer att använda MedlinePlus-sökmotorn. Detta tillvägagångssätt är mer effektivt med diagnoser (se information om problemkoden ovan) istället för textsträngar för labtest. Din begäran om laboratorietestinformation bör se ut som något av följande.
Exempel på begäran om laboratorietester
För att begära information för en engelsktalande kan din förfrågan se ut som något av följande: 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 = sv https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = sv
För att begära information för en spansktalande kan din begäran se ut som något av följande: 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
Policy för godtagbar användning
För att undvika överbelastning av MedlinePlus-servrarna kräver NLM att användare av MedlinePlus Connect inte skickar mer än 100 förfrågningar per minut per IP-adress. Förfrågningar som överskrider denna gräns kommer inte att betjänas och tjänsten återställs inte under 300 sekunder eller förrän begärandegraden faller under gränsen, beroende på vilket som kommer senare. För att begränsa antalet förfrågningar som du skickar till Connect rekommenderar NLM cachningsresultat under en 12-24 timmarsperiod.
Denna policy finns för att säkerställa att tjänsten förblir tillgänglig och tillgänglig för alla användare. Om du har ett specifikt användningsfall som kräver att du skickar ett stort antal förfrågningar till MedlinePlus Connect och därmed överskrider den begärandegräns som anges i denna policy, vänligen kontakta oss. NLM-personal kommer att utvärdera din begäran och avgöra om ett undantag kan beviljas. Läs också dokumentationen för MedlinePlus XML-filer. Dessa XML-filer innehåller fullständiga hälsoämnesregister och kan fungera som en alternativ metod för åtkomst till MedlinePlus-data.
Mer information
Sovjetisk
Meralgia paresthetica: vad det är, symtom och hur man behandlar det
