MedlinePlus Connect: Webová aplikace

Obsah

• Přehled webových aplikací
• Žádosti o diagnostické (problémové) kódy
• Volitelné parametry
• Příklady žádostí o problémové kódy
• Žádosti o informace o drogách
• Volitelné parametry
• Příklady žádostí o kódy drog
• Žádosti o informace o laboratorním testu
• Volitelné parametry
• Příklady žádostí o laboratorní testy
• Zásady přijatelného použití
• Více informací

MedlinePlus Connect je k dispozici jako webová aplikace nebo webová služba. Níže jsou uvedeny technické podrobnosti pro implementaci webové aplikace, která odpovídá na požadavky na základě:

Pokud se rozhodnete použít MedlinePlus Connect, zaregistrujte se do seznamu e-mailů, abyste drželi krok s vývojem a vyměňujte si nápady se svými kolegy. Sdělte nám, prosím, pokud implementujete MedlinePlus Connect, kontaktujte nás. Můžete propojit a zobrazit údaje poskytnuté MedlinePlus Connect. Další informace o tom, jak propojit obsah MedlinePlus mimo tuto službu, najdete v našich pokynech a pokynech k propojení.

Přehled webových aplikací

Rozhraní API pro webovou aplikaci odpovídá specifikaci požadavku na znalostní bázi HL7 Context-Aware Knowledge Retrieval (Infobutton) vyžadující implementaci na základě adresy URL. Struktura požadavku označuje, jaký typ kódu odesíláte. Ve všech případech je základní adresa URL webové aplikace: https://connect.medlineplus.gov/application

MedlinePlus Connect používá připojení HTTPS. Požadavky HTTP nebudou přijaty a stávající implementace využívající HTTP by se měly aktualizovat na HTTPS.

Žádosti o diagnostické (problémové) kódy

MedlinePlus Connect spojuje kódy ICD-10-CM, ICD-9-CM nebo SNOMED CT se souvisejícími stránkami MedlinePlus týkajícími se zdraví, genetickými stránkami nebo stránkami od jiných institutů NIH. Například pacientovi s diagnostikovaným kódem ICD-9-CM 493.12, Vnější astma s exacerbací, může být předložen odkaz v elektronickém zdravotním záznamu (EHR), který vede na stránku Astma v MedlinePlus.

Tento odkaz zobrazí stránku s prázdným vyhledávacím polem. Existují dva požadované parametry pro jakýkoli dotaz k této aplikaci:

1. Určete systém kódů problémů, který budete používat.
   

   Pro použití ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Pro použití ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Pro použití SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Určete skutečný kód, který se pokoušíte vyhledat:
   mainSearchCriteria.v.c = 250,33

Volitelné parametry

Určete název / název kódu problému. Odeslání žádného kódu nebude mít za následek dotaz do vyhledávače MedlinePlus. Pokud zadáte kód a název / název kódu, ale MedlinePlus Connect nemá žádné výsledky, na stránce odpovědí se zobrazí vyhledávací pole MedlinePlus předvyplněné jménem / titulem. mainSearchCriteria.v.dn = Diabetes mellitus s nekontrolovaným jiným kóma typu 1

Určete, zda chcete, aby byl požadavek v angličtině nebo španělštině. Pokud není uveden, MedlinePlus Connect bude předpokládat, že jazykem je angličtina.

Pokud si přejete, aby odpověď na vyhledání kódu problému byla ve španělštině, použijte: informationRecipient.languageCode.c = es
(= sp také přijato)

Chcete-li určit angličtinu, použijte následující: informationRecipient.languageCode.c = en

Příklady žádostí o problémové kódy

Kompletní žádost o Diabetes Mellitus s jiným nekontrolovaným kóma typu 1, kód ICD-9 250,33, by pro španělsky mluvícího pacienta měla následující adresu URL: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250,33 & mainSearchCriteria.v.dn = Diabetes% 20mellitus% 20s% 20other% 20coma% 20typ% 201% 20nekontrolováno & informationRecipient.languageCode.c = es

Pacient s diagnózou „Pneumonie způsobená Pseudomonas“ pomocí kódu SNOMED CT 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonie% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = en

Volný dotaz bez kódu systému nebo problémového kódu použije vyhledávač MedlinePlus (pouze v angličtině): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

Žádosti o informace o drogách

Při příjmu RXCUI poskytuje aplikace MedlinePlus Connect ty nejlepší informace o lécích. Poskytuje také dobré výsledky při příjmu kódu NDC. MedlinePlus Connect může poskytovat odpovědi na požadavky na léčebný kód v angličtině nebo španělštině a vrátí odkaz na stránku s výsledky s nejlepšími shodami z informací o lécích MedlinePlus.

Pokud u žádostí o informace o léčivých přípravcích v angličtině nezasíláte kód NDC nebo RXCUI nebo pokud na základě kódu nenalezneme žádnou shodu, použijeme textový řetězec, který odešlete, k zobrazení nejlepší shody informací o lécích. V případě požadavků na informace o španělských lécích MedlinePlus Connect odpovídá pouze na NDC nebo RXCUI; nepoužívá textové řetězce. Je možné mít odpověď v angličtině, ale žádná odpověď ve španělštině.

Na jednu žádost o léčbu může být více odpovědí. Pro každý požadavek nemusí vždy existovat shoda. Pokud MedlinePlus Connect najde nulovou odpověď na žádost o lék, program zobrazí vyhledávací pole pro web MedlinePlus. Uživatel může zadat název drogy a může získat dobrou odpověď.

U žádostí o informace o lécích je základní adresa URL: https://connect.medlineplus.gov/application

Žádosti o informace o angličtině a španělštině mají různé požadavky. Chcete-li odeslat požadavek, uveďte tyto informace:

1. Určete typ léčebného kódu, který odesíláte. (Povinné pro angličtinu a španělštinu)
   

   Pro RXCUI použijte:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Pro použití NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

2. Určete skutečný kód, který se pokoušíte vyhledat. (Preferováno pro angličtinu, požadováno pro španělštinu)
   mainSearchCriteria.v.c = 637188
3. Identifikujte název léku pomocí textového řetězce. (Volitelné pro angličtinu, nepoužívá se pro španělštinu)
   mainSearchCriteria.v.dn = Chantix 0,5 MG perorální tableta

U požadavků v angličtině byste měli identifikovat minimálně kódový systém a kód nebo kódový systém a název drogy. Chcete-li dosáhnout nejlepších výsledků pro požadavky v angličtině, pošlete všechny tři. U španělských požadavků byste měli identifikovat kódový systém a kód.

Volitelné parametry

Při odesílání žádosti o informace v angličtině můžete uvést volitelný parametr názvu léku. To je podrobně popsáno ve výše uvedené části. Tento parametr se nepoužívá pro španělské požadavky.

Určete, zda chcete, aby byl požadavek v angličtině nebo španělštině. Pokud není uveden, MedlinePlus Connect bude předpokládat, že jazykem je angličtina.

Pokud si přejete, aby odpověď na vyhledávání kódu léku byla ve španělštině, použijte: informationRecipient.languageCode.c = es (= sp také přijato)

Chcete-li určit angličtinu, použijte následující: informationRecipient.languageCode.c = en

Příklady žádostí o kódy drog

Vaše žádost o informace o léku by měla vypadat jako jedna z následujících.

Chcete-li požádat o informace prostřednictvím RXCUI, měla by vaše žádost vypadat takto: 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% 20Oral% 20Tablet & informationRecipient.languageCode.c = en

Chcete-li požádat NDC o informace pro španělského mluvčího, měl by váš požadavek vypadat takto: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.languageCode.c = es

Chcete-li odeslat textový řetězec bez kódu léku, musíte identifikovat svůj dotaz jako požadavek typu NDC, aby MedlinePlus Connect věděl, že hledáte informace o lécích. Toto bude fungovat pouze pro angličtinu. Váš požadavek může vypadat takto: 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 = en

Žádosti o informace o laboratorním testu

MedlinePlus Connect poskytuje shody s informacemi o laboratorních testech, když obdrží požadavek LOINC. MedlinePlus Connect může poskytovat odpovědi na požadavky na laboratorní testy v angličtině nebo španělštině a vrátí odkaz na stránku s výsledky s nejlepšími shodami z informací o laboratorním testu MedlinePlus.

Pro žádosti o informace o laboratorním testu je základní adresa URL: https://connect.medlineplus.gov/application

Jedná se o dva požadované parametry pro jakýkoli laboratorní testovací dotaz pro tuto aplikaci:

1. Zjistěte, že používáte systém kódů LOINC.
   

   Pro LOINC použijte:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect také přijímá:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Určete skutečný kód, který se pokoušíte vyhledat.
   mainSearchCriteria.v.c = 3187-2

Volitelné parametry

Určete název / název laboratorního testu. Tyto informace však nemají vliv na odpověď. mainSearchCriteria.v.dn = Stanovení faktoru IX

Určete, zda chcete, aby byl požadavek v angličtině nebo španělštině. Pokud není uveden, MedlinePlus Connect bude předpokládat, že jazykem je angličtina.

Pokud si přejete, aby odpověď na vyhledávání problémového kódu byla ve španělštině, použijte: informationRecipient.languageCode.c = es (= sp také přijato)

Chcete-li určit angličtinu, použijte následující: informationRecipient.languageCode.c = en

Volný dotaz bez systémového kódu nebo laboratorního kódu použije vyhledávací modul MedlinePlus. Tento přístup je efektivnější s diagnostikami (viz informace o kódu problému výše) namísto textových řetězců testovacího testu. Váš požadavek na informace o laboratorním testu by měl vypadat jako jeden z následujících.

Příklady žádostí o laboratorní testy

Chcete-li požádat o informace pro anglicky mluvícího, váš požadavek může vypadat jako jeden z následujících: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Factor% 20IX% 20assay & informationRecipient.languageCode.c = en https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.laguageCode = en

Chcete-li požádat o informace pro mluvčího španělštiny, může váš požadavek vypadat jako jeden z následujících: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Factor% 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 = es

Zásady přijatelného použití

Aby se zabránilo přetížení serverů MedlinePlus, NLM vyžaduje, aby uživatelé MedlinePlus Connect neposílali více než 100 požadavků za minutu na IP adresu. Žádosti, které překročí tento limit, nebudou obsluhovány a služba nebude obnovena po dobu 300 sekund nebo dokud rychlost požadavku neklesne pod limit, podle toho, co nastane později. Chcete-li omezit počet požadavků, které odesíláte do služby Connect, NLM doporučuje ukládat výsledky do mezipaměti po dobu 12–24 hodin.

Tato zásada je zavedena, aby zajistila, že služba zůstane dostupná a přístupná všem uživatelům. Pokud máte konkrétní případ použití, který vyžaduje, abyste odeslali velké množství požadavků na MedlinePlus Connect, a překročili tak limit rychlosti žádostí uvedený v těchto zásadách, kontaktujte nás. Zaměstnanci NLM vyhodnotí váš požadavek a určí, zda může být udělena výjimka. Přečtěte si také dokumentaci souborů MedlinePlus XML. Tyto soubory XML obsahují úplné záznamy témat o zdraví a mohou sloužit jako alternativní metoda přístupu k datům MedlinePlus.

Více informací