MedlinePlus Connect: webová aplikácia

Obsah

• Prehľad webových aplikácií
• Žiadosti o diagnostické (problémové) kódy
• Nepovinné parametre
• Príklady žiadostí o kódy problémov
• Žiadosti o informácie o drogách
• Nepovinné parametre
• Príklady žiadostí o kódy liekov
• Žiadosti o informácie o laboratórnom teste
• Nepovinné parametre
• Príklady žiadostí o laboratórne testy
• Pravidlá prijateľného použitia
• Viac informácií

MedlinePlus Connect je k dispozícii ako webová aplikácia alebo webová služba. Ďalej sú uvedené technické podrobnosti implementácie webovej aplikácie, ktorá reaguje na požiadavky na základe:

Ak sa rozhodnete používať MedlinePlus Connect, zaregistrujte sa do zoznamu e-mailov, aby ste držali krok s vývojom a vymieňajte si nápady so svojimi kolegami. Ak implementujete MedlinePlus Connect, povedzte nám, prosím, kontaktujte nás. Môžete prepojiť a zobraziť údaje poskytované serverom MedlinePlus Connect. Viac informácií o tom, ako prepojiť na obsah MedlinePlus mimo túto službu, nájdete v našich pokynoch a pokynoch na prepojenie.

Prehľad webových aplikácií

Rozhranie API pre webovú aplikáciu je v súlade so špecifikáciou implementácie založenej na URL HL7 Context-Aware Knowledge Retrieval (Infobutton). Štruktúra žiadosti naznačuje, aký typ kódu odosielate. Vo všetkých prípadoch je základná adresa URL webovej aplikácie: https://connect.medlineplus.gov/application

Aplikácia MedlinePlus Connect používa pripojenie HTTPS. HTTP požiadavky nebudú akceptované a existujúce implementácie využívajúce HTTP by sa mali aktualizovať na HTTPS.

Žiadosti o diagnostické (problémové) kódy

Aplikácia MedlinePlus Connect spáruje kódy ICD-10-CM, ICD-9-CM alebo SNOMED CT so súvisiacimi stránkami MedlinePlus venovanými zdraviu, stránkami genetiky alebo stránkami iných ústavov NIH. Napríklad pacientovi s diagnostikovaným kódom ICD-9-CM 493.12, Vonkajšia astma s exacerbáciou, môže byť prezentovaný odkaz v elektronickom zdravotnom zázname (EHR), ktorý vedie na stránku Astma v MedlinePlus.

Tento odkaz zobrazí stránku s prázdnym vyhľadávacím poľom. Existujú dva požadované parametre pre akýkoľvek dotaz na túto aplikáciu:

1. Identifikujte systém kódov problémov, ktorý budete používať.
   

   Pre použitie ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Pre použitie ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Pre použitie SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Uveďte skutočný kód, ktorý sa pokúšate vyhľadať:
   mainSearchCriteria.v.c = 250,33

Nepovinné parametre

Uveďte názov / názov kódu problému. Odoslanie žiadneho kódu nebude mať za následok dopyt do vyhľadávacieho nástroja MedlinePlus. Ak zadáte kód a názov / názov kódu, ale MedlinePlus Connect nemá žiadne výsledky, na stránke s odpoveďami sa zobrazí vyhľadávacie pole MedlinePlus s vopred vyplneným menom / titulom. mainSearchCriteria.v.dn = Diabetes mellitus s inou nekontrolovanou inou kómou typu 1

Uveďte, či chcete, aby bola žiadosť v angličtine alebo španielčine. Aplikácia MedlinePlus Connect bude vychádzať z toho, že ak nie je uvedený inak, bude ako jazyk použitý jazyk English.

Ak chcete, aby bola odpoveď na vyhľadanie kódu problému v španielčine, použite: informationRecipient.languageCode.c = es
(= sp tiež akceptované)

Na zadanie angličtiny použite nasledujúci príkaz: informationRecipient.languageCode.c = sk

Príklady žiadostí o kódy problémov

Kompletná žiadosť o Diabetes Mellitus s inou nekontrolovanou kómou typu 1, kódom ICD-9 250.33, pre španielsky hovoriaceho pacienta by mala túto 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% 20nekontrolovaný & informationRecipient.languageCode.c = es

Pacient s diagnózou „Pneumónia spôsobená Pseudomonas“ pomocou 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= Pneumónia% 20due% 20to% 20Pseudomonas% 20% 28rozchod% 29 & informationRecipient.languageCode.c = sk

Freeformový dopyt bez kódového systému alebo problémového kódu použije vyhľadávací modul MedlinePlus (iba v angličtine): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

Žiadosti o informácie o drogách

Aplikácia MedlinePlus Connect poskytuje najlepšie informácie o liekoch pri prijatí RXCUI. Poskytuje tiež dobré výsledky pri prijímaní kódu NDC. Aplikácia MedlinePlus Connect dokáže odpovedať na žiadosti o kód lieku v angličtine alebo španielčine a vráti odkaz na stránku s výsledkami, ktorá najlepšie zodpovedá informáciám o lieku MedlinePlus.

Ak pri žiadostiach o informácie o liekoch v angličtine neodošlete kód NDC alebo RXCUI alebo ak na základe kódu nenájdeme zhodu, použijeme textový reťazec, ktorý odošlete, na zobrazenie najlepšej zhody informácií o lieku. V prípade žiadostí o informácie o španielskych liekoch reaguje MedlinePlus Connect iba na NDC alebo RXCUI; nepoužíva textové reťazce. Je možné mať odpoveď v angličtine, ale žiadna odpoveď v španielčine.

Na jednu žiadosť o liek môže byť viac odpovedí. Môže sa stať, že pre každú požiadavku nemusí byť vždy zhoda. Ak MedlinePlus Connect nájde nulovú odpoveď na žiadosť o liek, program zobrazí vyhľadávacie pole pre stránku MedlinePlus. Používateľ môže zadať názov drogy a môže získať dobrú odpoveď.

V prípade žiadostí o informácie o lieku je základná adresa URL: https://connect.medlineplus.gov/application

Žiadosti o informácie o anglickom a španielskom lieku majú odlišné požiadavky. Ak chcete poslať žiadosť, uveďte tieto informácie:

1. Identifikujte typ kódu lieku, ktorý odosielate. (Povinné pre angličtinu a španielčinu)
   

   Pre RXCUI použite:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Pre použitie NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

2. Identifikujte skutočný kód, ktorý sa pokúšate vyhľadať. (Preferované pre angličtinu, požadované pre španielčinu)
   mainSearchCriteria.v.c = 637188
3. Identifikujte názov lieku pomocou textového reťazca. (Voliteľné pre angličtinu, nepoužíva sa pre španielčinu)
   mainSearchCriteria.v.dn = Chantix 0,5 MG perorálna tableta

V prípade požiadaviek v angličtine by ste mali identifikovať minimálne kódový systém a kód alebo kódový systém a názov lieku. Za účelom dosiahnutia najlepších výsledkov v angličtine pošlite všetky tri. Pri španielskych požiadavkách by ste mali identifikovať kódový systém a kód.

Nepovinné parametre

Pri zasielaní žiadosti o informácie v angličtine môžete uviesť voliteľný parameter názvu lieku. Toto je podrobne uvedené v predchádzajúcej časti. Tento parameter sa nepoužíva pre španielske požiadavky.

Uveďte, či chcete, aby bola žiadosť v angličtine alebo španielčine. Aplikácia MedlinePlus Connect bude vychádzať z toho, že ak nie je uvedený inak, bude ako jazyk použitý jazyk English.

Ak chcete, aby bola odpoveď na vyhľadanie kódu lieku v španielčine, použite: informationRecipient.languageCode.c = es (= sp tiež akceptované)

Na zadanie angličtiny použite nasledujúci príkaz: informationRecipient.languageCode.c = sk

Príklady žiadostí o kódy liekov

Vaša žiadosť o informácie o lieku by mala vyzerať ako jedna z nasledujúcich.

Ak chcete požiadať o informácie prostredníctvom RXCUI, vaša žiadosť by mala vyzerať 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 = sk

Ak chcete od španielskeho hovorcu požiadať NDC o informácie, vaša žiadosť by mala vyzerať 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

Ak chcete odoslať textový reťazec bez kódu lieku, musíte identifikovať svoj dopyt ako požiadavku typu NDC, aby služba MedlinePlus Connect vedela, že hľadáte informácie o lieku. Bude to fungovať iba pre angličtinu. Vaša žiadosť môže vyzerať 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

Žiadosti o informácie o laboratórnom teste

Aplikácia MedlinePlus Connect poskytuje zhody s informáciami o laboratórnych testoch, keď dostane požiadavku LOINC. Aplikácia MedlinePlus Connect dokáže poskytnúť odpovede na požiadavky na laboratórne testy v angličtine alebo španielčine a vráti odkaz na stránku s výsledkami s najlepšími zhodami z informácií o laboratórnom teste MedlinePlus.

Pre žiadosti o informácie o laboratórnom teste je základná adresa URL: https://connect.medlineplus.gov/application

Toto sú dva požadované parametre pre akýkoľvek laboratórny testovací dopyt pre túto aplikáciu:

1. Zistite, že používate systém kódov LOINC.
   

   Pre LOINC použite:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect bude akceptovať aj:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Identifikujte skutočný kód, ktorý sa pokúšate vyhľadať.
   mainSearchCriteria.v.c = 3187-2

Nepovinné parametre

Identifikujte názov / názov laboratórneho testu. Táto informácia však nemá vplyv na reakciu. mainSearchCriteria.v.dn = Stanovenie faktora IX

Uveďte, či chcete, aby bola žiadosť v angličtine alebo španielčine. Aplikácia MedlinePlus Connect bude vychádzať z toho, že ak nie je uvedený inak, bude ako jazyk použitý jazyk English.

Ak chcete, aby bola odpoveď na vyhľadanie kódu problému v španielčine, použite: informationRecipient.languageCode.c = es (= sp tiež akceptované)

Na zadanie angličtiny použite nasledujúci príkaz: informationRecipient.languageCode.c = sk

Voľný dopyt bez kódového systému alebo laboratórneho kódu použije vyhľadávací modul MedlinePlus. Tento prístup je efektívnejší pri diagnostikách (pozrite si informácie o kóde problému vyššie) namiesto textových reťazcov laboratórneho testu. Vaša žiadosť o informácie o laboratórnom teste by mala vyzerať ako jedna z nasledujúcich.

Príklady žiadostí o laboratórne testy

Ak chcete požiadať o informácie pre anglicky hovoriaceho človeka, vaša žiadosť môže vyzerať ako jedna z nasledujúcich: 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 = sk https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode = en

Ak chcete požiadať o informácie pre španielsky hovoriaceho, vaša žiadosť môže vyzerať ako jedna z nasledujúcich: 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 = es

Pravidlá prijateľného použitia

Aby sa zabránilo preťaženiu serverov MedlinePlus, NLM vyžaduje, aby používatelia MedlinePlus Connect neposielali viac ako 100 požiadaviek za minútu na jednu adresu IP. Žiadosti, ktoré presiahnu tento limit, nebudú vybavené a služba nebude obnovená po dobu 300 sekúnd alebo dovtedy, kým miera žiadosti neklesne pod limit, podľa toho, čo nastane neskôr. Aby ste obmedzili počet žiadostí, ktoré posielate na server Connect, NLM odporúča ukladať výsledky do medzipamäte na dobu 12 - 24 hodín.

Toto pravidlo je zavedené s cieľom zabezpečiť, aby služba zostala dostupná a prístupná všetkým používateľom. Ak máte konkrétny prípad použitia, ktorý vyžaduje, aby ste odoslali veľké množstvo požiadaviek na server MedlinePlus Connect, a teda prekročili limit rýchlosti žiadostí uvedený v týchto zásadách, kontaktujte nás. Pracovníci NLM vyhodnotia vašu žiadosť a určia, či je možné udeliť výnimku. Prečítajte si tiež dokumentáciu k súborom XML MedlinePlus. Tieto súbory XML obsahujú úplné záznamy o témach týkajúcich sa zdravia a môžu slúžiť ako alternatívna metóda prístupu k údajom MedlinePlus.

Viac informácií