MedlinePlus Connect: webová služba

Obsah

• Přehled webových služeb
• Výstupní parametry
• Žádosti o diagnostické (problémové) kódy
• Volitelné parametry
• Popis vybraných prvků atomů (nebo objektů JSON) v reakci na žádosti o problémový kód
• Příklady žádostí o problémové kódy
• Související služby a soubory
• Žádosti o informace o drogách
• Volitelné parametry
• Popis vybraných prvků atomů (nebo objektů JSON) v reakci na žádosti o léčbu
• Příklady žádostí o kódy drog
• Žádosti o informace o laboratorním testu
• Volitelné parametry
• Popis vybraných prvků atomů (nebo objektů JSON) v reakci na požadavky na laboratorní test
• 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é služby, která odpovídá na požadavky na základě:

Můžete vrátit odkaz a zobrazit data vrácená MedlinePlus Connect. Stránky MedlinePlus nesmíte kopírovat na svůj web. Pokud používáte data z webové služby MedlinePlus Connect, uveďte, že informace pocházejí z MedlinePlus.gov, ale nepoužívejte logo MedlinePlus nebo z čehož jinak vyplývá, že MedlinePlus podporuje váš konkrétní produkt. Další pokyny najdete na stránce API NLM. Další informace o tom, jak propojit obsah MedlinePlus mimo tuto službu, najdete v našich pokynech a pokynech k propojení.

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.

Přehled webových služeb

Parametry požadavků na webové služby jsou v souladu s HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation Guide. Odpověď založená na REST odpovídá příručce implementace architektury orientované na služby HL7 Context-Aware Knowledge Retrieval (Infobutton). Výstupem požadavku může být XML ve formátu zdroje Atom, JSON nebo JSONP.

Struktura požadavku označuje, jaký typ kódu odesíláte. Ve všech případech je základní adresa URL webové služby: https://connect.medlineplus.gov/service

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.

Výstupní parametry

Tyto parametry jsou volitelné. Pokud je vynecháte, výchozí odpovědí jsou anglické informace ve formátu XML.

Jazyk
Určete, zda chcete, aby byla odpověď 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

Formát
Určete, zda chcete, aby formát odpovědi byl XML, JSON nebo JSONP. XML je výchozí.

Chcete-li požádat o JSON, použijte:

knowledgeResponseType = aplikace / json

Pro JSONP použijte:

knowledgeResponseType = application / javascript & callback = CallbackFunction kde CallbackFunction je název, kterému dáte funkci zpětného volání.

Pro odpověď v XML použijte:

knowledgeResponseType = text / xml nebo vynechejte parametr knowledgeResponseType mimo požadavek.

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

Pokud jde o problémový kód, MedlinePlus Connect vrátí odkazy a informace ze stránek věnovaných zdraví MedlinePlus, genetických stránek nebo stránek od jiných institutů NIH.

MedlinePlus Connect vrátí následující:

Pro každý kód nemusí vždy existovat shoda. V takových případech MedlinePlus Connect vrátí nulovou odpověď.

Základní adresa URL služby je: https://connect.medlineplus.gov/service

U každého dotazu na tuto službu existují dva požadované parametry:

1. Systém kódů
   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. Kód
   Určete skutečný kód, který se pokoušíte vyhledat:
   mainSearchCriteria.v.c = 250,33

Volitelné parametry

Název kódu
Můžete také identifikovat název / název problémového kódu. Tyto informace však nemají vliv na odezvu (na rozdíl od webové aplikace MedlinePlus Connect, kde lze použít informace o názvu / názvu). mainSearchCriteria.v.dn = Diabetes mellitus s nekontrolovaným jiným typem kómy 1 Viz jazyk výše a výstupní formáty výše v části Výstupní parametry.

Popis vybraných prvků atomů (nebo objektů JSON) v reakci na žádosti o problémový kód

Živel	Uzel třídy	Popis
titul		Název shodné stránky tématu zdraví MedlinePlus nebo stránky GHR
odkaz		URL pro shodnou stránku tématu zdraví MedlinePlus nebo stránku GHR
souhrn		Úplné shrnutí tématu týkajícího se zdraví. To zahrnuje vložené odkazy na další relevantní témata týkající se zdraví a veškeré formátování, včetně odrážek a mezer mezi odstavci. Souhrn je v HTML. U stránek GHR je uvedena první část celé stránky.
souhrn		Synonyma k tématu. Tito jsou na stránce tématu zdraví označováni jako „Také se nazývají“. Ne všechna témata mají výrazy „Také se nazývají“.
souhrn		Potvrzení atribuce za text souhrnu, pokud většina souhrnu pocházela od jiné federální agentury. Ne všechny souhrny mají přiřazení. Nepřiřazený text je původní pro MedlinePlus.
souhrn		Vybrané odkazy spojené s tématem. To zahrnuje název stránky, URL a přidruženou organizaci (je-li k dispozici). Odkazy jsou formátovány v seznamu s odrážkami. Ne všechna témata mají tyto odkazy. Počet odkazů se může pohybovat od nuly do desítek.

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, pro španělsky mluvícího pacienta by měla následující adresu URL: https://connect.medlineplus.gov/service?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 se stejnou diagnózou, ale požadovaný formát je JSON a jazykem je angličtina: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Pacient s diagnózou „Pneumonie způsobená Pseudomonas“ pomocí kódu SNOMED CT 41381004: https://connect.medlineplus.gov/service?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

Pacient se stejnou diagnózou, ale požadovaným formátem je JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=Callback=Callback=Callback

Související služby a soubory

Chcete-li dostávat témata týkající se zdraví MedlinePlus v reakci na textové požadavky, na rozdíl od kódů problémů, prozkoumejte webovou službu MedlinePlus. Také pokud potřebujete úplnou sadu témat zdraví MedlinePlus ve formátu XML, podívejte se na naši stránku se soubory XML.

Žá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 v angličtině nebo španělštině.

Pokud u žádostí o informace o lécích v angličtině neposíláte NDC nebo RXCUI nebo pokud na základě kódu nenalezneme žádnou shodu, aplikace použije textový řetězec, který odešlete, k zobrazení nejlepší shody informací o lécích. Na žádosti o informace o španělských lécích reaguje MedlinePlus Connect pouze na NDC nebo RXCUI a nepoužívá textové řetězce. Je možné mít odpověď v angličtině, ale žádná odpověď ve španělštině.

Webová služba MedlinePlus Connect vrátí následující:

Na jednu žádost o léčbu může být více odpovědí. Pro každý požadavek nemusí vždy existovat shoda. V takových případech MedlinePlus Connect vrátí nulovou odpověď.

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

Chcete-li odeslat požadavek, uveďte tyto informace:

1. Systém kódů
   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

   MedlinePlus Connect může také přijímat textový řetězec pro žádosti o informace o lécích v angličtině, ale musíte označit, že hledáte informace o lécích, a to zahrnutím jednoho ze dvou kódových systémů uvedených výše.
2. Kód
   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. Název drogy
   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

Minimálně byste měli identifikovat 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. Zašlete kódový systém a kód pro španělské žádosti.

Volitelné parametry

Název kódu

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. mainSearchCriteria.v.dn = Chantix 0,5 MG perorální tableta

Viz výše část Výstupní parametry, kde najdete podrobnosti o jazykových a výstupních formátech.

Popis vybraných prvků atomů (nebo objektů JSON) v reakci na žádosti o léčbu

Živel	Popis
titul	Nadpis pro odpovídající stránku s léky MedlinePlus
odkaz	URL pro odpovídající stránku s léky MedlinePlus
autor	Uvedení zdroje pro informace o léčbě

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

Vaše žádost o informace o léčbě 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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=637188&mainSearchCriteria.v.dn=Chantix% 200,5% 20MG% 20Oral% 20Tablet a informaceRecipient.languageCode.c = en

Chcete-li požádat NDC o informace pro španělského mluvčího, měla by vaše žádost vypadat takto: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-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 anglické požadavky. Váš požadavek může vypadat takto: 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 = en

Žádosti o informace o laboratorním testu

MedlinePlus Connect poskytuje shody s informacemi o laboratorních testech, když obdrží požadavek LOINC. Tato služba může poskytnout odpověď v angličtině nebo španělštině.

Webová služba MedlinePlus Connect vrátí následující:

Pro každý kód nemusí vždy existovat shoda. V takových případech MedlinePlus Connect vrátí nulovou odpověď.

Základní adresa URL služby je: https://connect.medlineplus.gov/service

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

1. Systém kódů
   

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

   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. Kód
   identifikujte skutečný kód, který se pokoušíte vyhledat:
   mainSearchCriteria.v.c = 3187-2

Volitelné parametry

Název kódu

Můžete také identifikovat název laboratorního testu. Tyto informace však nemají vliv na odpověď. mainSearchCriteria.v.dn = Stanovení faktoru IX

Viz výše část Výstupní parametry, kde najdete podrobnosti o jazykových a výstupních formátech.

Popis vybraných prvků atomů (nebo objektů JSON) v reakci na požadavky na laboratorní test

Živel	Popis
titul	Název shodné laboratorní testovací stránky MedlinePlus
odkaz	URL pro odpovídající laboratorní testovací stránku MedlinePlus
souhrn	Úryvek z obsahu stránky
autor	Uvedení zdroje pro obsah laboratorního testu

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/service?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/service?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/service?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/service?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í