MedlinePlus Connect: aplicație web

Conţinut
- Prezentare generală a aplicației web
- Solicitări pentru coduri de diagnosticare (problemă)
- Parametrii opționali
- Exemple de cereri pentru coduri de probleme
- Cereri de informații despre droguri
- Parametrii opționali
- Exemple de cereri de coduri de droguri
- Solicitări pentru informații despre testul de laborator
- Parametrii opționali
- Exemple de cereri de teste de laborator
- Politica de utilizare acceptabilă
- Mai multe informatii
MedlinePlus Connect este disponibil ca aplicație Web sau serviciu Web. Mai jos sunt detaliile tehnice pentru implementarea aplicației Web, care răspunde solicitărilor bazate pe:
Dacă decideți să utilizați MedlinePlus Connect, înscrieți-vă la lista de e-mailuri pentru a ține pasul cu evoluțiile și a face schimb de idei cu colegii dvs. Vă rugăm să ne spuneți dacă implementați MedlinePlus Connect contactându-ne. Sunteți binevenit (ă) să conectați și să afișați datele furnizate de MedlinePlus Connect. Pentru mai multe informații despre cum să vă conectați la conținutul MedlinePlus în afara acestui serviciu, vă rugăm să consultați instrucțiunile și instrucțiunile noastre privind conectarea.
Prezentare generală a aplicației web
API-ul pentru aplicația Web este conform cu specificația de implementare bazată pe adresele URL a cererii de cunoștințe (Infobutton) HL7 Context-Aware Knowledge Retrieval (Infobutton). Structura cererii indică ce tip de cod trimiteți. În toate cazurile, adresa URL de bază pentru aplicația Web este: https://connect.medlineplus.gov/application
MedlinePlus Connect utilizează conexiuni HTTPS. Solicitările HTTP nu vor fi acceptate și implementările existente care utilizează HTTP ar trebui să se actualizeze la HTTPS.
Solicitări pentru coduri de diagnosticare (problemă)
MedlinePlus Connect se potrivește codurilor ICD-10-CM, ICD-9-CM sau SNOMED CT cu pagini legate de subiectele de sănătate MedlinePlus, pagini de genetică sau pagini de la alte institute NIH. De exemplu, unui pacient diagnosticat cu codul ICD-9-CM 493.12, astm extrinsec cu exacerbare, i s-ar putea prezenta un link într-un dosar de sănătate electronic (EHR) care duce la pagina MedlinePlus Astm.
Pentru solicitări în funcție de problemă, adresa URL de bază a aplicației este: https://connect.medlineplus.gov/applicationAcest link afișează o pagină cu o casetă de căutare goală. Există doi parametri necesari pentru orice interogare a acestei aplicații:
- Identificați sistemul de cod problemă pe care îl veți utiliza.
- Pentru utilizarea ICD-10-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- Pentru utilizarea ICD-9-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- Pentru utilizarea SNOMED CT:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Identificați codul real pe care încercați să îl căutați:
mainSearchCriteria.v.c = 250.33
Parametrii opționali
Identificați numele / titlul codului problemei. Dacă nu trimiteți cod, va rezulta o interogare către motorul de căutare MedlinePlus. Dacă specificați un cod și numele / titlul codului, dar MedlinePlus Connect nu are rezultate, pagina de răspuns va afișa o casetă de căutare MedlinePlus prepopulată cu numele / titlul. mainSearchCriteria.v.dn = Diabet zaharat cu altă comă tip 1 necontrolată
Identificați dacă doriți ca solicitarea să fie în engleză sau spaniolă. MedlinePlus Connect va presupune că limba engleză este limba dacă nu este specificată.
Dacă doriți ca răspunsul la căutarea codului problemei să fie în spaniolă, utilizați: informationRecipient.languageCode.c = es
(= sp acceptat și)
Pentru a specifica limba engleză, utilizați următoarele: informationRecipient.languageCode.c = ro
Exemple de cereri pentru coduri de probleme
O cerere completă pentru diabet zaharat cu comă de tip 1 necontrolată, cod ICD-9 250.33, pentru un pacient vorbitor de spaniolă ar avea următoarea adresă URL: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabet% 20mellitus% 20cu% 20other% 20coma% 20type% 201% 20uncontrolled & informationRecipient.languageCode.c = es
Un pacient diagnosticat cu „Pneumonie cauzată de Pseudomonas” utilizând codul SNOMED CT 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.vc=41381004&mainSearchCriteria Pneumonia% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = ro
O interogare de formă liberă, fără sistem de cod sau cod de problemă, va utiliza motorul de căutare MedlinePlus (numai în limba engleză): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
Cereri de informații despre droguri
MedlinePlus Connect oferă cele mai bune potriviri de informații despre medicamente atunci când primiți un RXCUI. De asemenea, oferă rezultate bune atunci când primiți un cod NDC. MedlinePlus Connect poate oferi răspunsuri la cererile de cod de medicamente în engleză sau spaniolă și vă va returna un link către o pagină de rezultate cu cele mai bune potriviri din informațiile despre medicament MedlinePlus.
Pentru solicitări de informații despre medicamente în limba engleză, dacă nu trimiteți un cod NDC sau RXCUI sau dacă nu găsim nicio potrivire bazată pe cod, vom folosi șirul de text pe care îl trimiteți pentru a afișa cea mai bună potrivire cu informații despre medicamente. Pentru solicitări de informații despre medicamente în Spania, MedlinePlus Connect răspunde numai la NDC-uri sau RXCUI-uri; nu folosește șiruri de text. Este posibil să aveți un răspuns în engleză, dar niciun răspuns în spaniolă.
Pot exista răspunsuri multiple la o solicitare de medicamente. Este posibil să nu existe întotdeauna o potrivire pentru fiecare solicitare. Dacă MedlinePlus Connect găsește un răspuns nul pentru o cerere de droguri, programul afișează o casetă de căutare pentru site-ul MedlinePlus. Un utilizator poate introduce un nume de medicament și poate primi un răspuns bun.
Pentru solicitările de informații despre medicamente, adresa URL de bază este: https://connect.medlineplus.gov/application
Cererile de informații despre medicamente în limba engleză și spaniolă au cerințe diferite. Pentru a trimite o solicitare, includeți aceste informații:
- Identificați tipul de cod de medicament pe care îl trimiteți. (Obligatoriu pentru engleză și spaniolă)
- Pentru utilizarea RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Pentru utilizarea NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Identificați codul real pe care încercați să îl căutați. (Preferat pentru engleză, obligatoriu pentru spaniolă)
mainSearchCriteria.v.c = 637188 - Identificați numele medicamentului cu un șir de text. (Opțional pentru engleză, neutilizat pentru spaniolă)
mainSearchCriteria.v.dn = Tabletă orală Chantix 0,5 MG
Pentru cererile în limba engleză, trebuie să identificați cel puțin sistemul de coduri și codul, sau sistemul de coduri și numele medicamentului. Trimiteți-le pe toate trei pentru cele mai bune rezultate pentru solicitările în limba engleză. Pentru solicitările spaniole, trebuie să identificați sistemul de cod și codul.
Parametrii opționali
Când trimiteți o cerere de informații în limba engleză, puteți include parametrul opțional al numelui medicamentului. Acest lucru este detaliat în secțiunea de mai sus. Acest parametru nu este utilizat pentru solicitările spaniole.
Identificați dacă doriți ca solicitarea să fie în engleză sau spaniolă. MedlinePlus Connect va presupune că limba engleză este limba dacă nu este specificată.
Dacă doriți ca răspunsul la căutarea codului medicamentului să fie în spaniolă, utilizați: informationRecipient.languageCode.c = es (= sp acceptat și)
Pentru a specifica limba engleză, utilizați următoarele: informationRecipient.languageCode.c = ro
Exemple de cereri de coduri de droguri
Solicitarea dvs. de informații despre medicamente ar trebui să arate ca una dintre următoarele.
Pentru a solicita informații de la un RXCUI, solicitarea dvs. ar trebui să arate astfel: 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 = ro
Pentru a solicita informații unui NDC pentru un vorbitor de limbă spaniolă, solicitarea dvs. ar trebui să arate astfel: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.languageCode.c = es
Pentru a trimite un șir de text fără un cod de medicament, trebuie să identificați interogarea dvs. ca o cerere de tip NDC, astfel încât MedlinePlus Connect să știe că căutați informații despre medicamente. Acest lucru va funcționa numai pentru limba engleză. Solicitarea dvs. ar putea arăta astfel: 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 = ro
Solicitări pentru informații despre testul de laborator
MedlinePlus Connect furnizează potriviri cu informațiile de testare de laborator la primirea unei cereri LOINC. MedlinePlus Connect poate oferi răspunsuri la cererile de test de laborator în engleză sau spaniolă și va returna un link către o pagină de rezultate cu cele mai bune potriviri din informațiile de testare de laborator MedlinePlus.
Pentru solicitări de informații de test de laborator, adresa URL de bază este: https://connect.medlineplus.gov/application
Aceștia sunt doi parametri necesari pentru orice interogare de test de laborator către această aplicație:
- Identificați că utilizați sistemul de cod LOINC.
- Pentru utilizarea LOINC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect va accepta, de asemenea:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Identificați codul real pe care încercați să îl căutați.
mainSearchCriteria.v.c = 3187-2
Parametrii opționali
Identificați numele / titlul testului de laborator. Cu toate acestea, aceste informații nu au impact asupra răspunsului. mainSearchCriteria.v.dn = Testul factorului IX
Identificați dacă doriți ca solicitarea să fie în engleză sau spaniolă. MedlinePlus Connect va presupune că limba engleză este limba dacă nu este specificată.
Dacă doriți ca răspunsul la căutarea codului problemei să fie în spaniolă, utilizați: informationRecipient.languageCode.c = es (= acceptat și sp)
Pentru a specifica limba engleză, utilizați următoarele: informationRecipient.languageCode.c = ro
O interogare de formă liberă, fără sistem de cod sau cod de laborator, va utiliza motorul de căutare MedlinePlus. Această abordare este mai eficientă cu diagnosticul (vezi informațiile despre codul problemei de mai sus) în loc de șiruri de text de test de laborator. Solicitarea de informații despre testul de laborator ar trebui să arate ca una dintre următoarele.
Exemple de cereri de teste de laborator
Pentru a solicita informații pentru un vorbitor de limba engleză, solicitarea dvs. poate arăta ca una dintre următoarele: 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.languageCode.c = ro
Pentru a solicita informații pentru un vorbitor de spaniolă, solicitarea dvs. poate arăta ca una dintre următoarele: 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.c = es
Politica de utilizare acceptabilă
Pentru a evita supraîncărcarea serverelor MedlinePlus, NLM solicită utilizatorilor MedlinePlus Connect să nu trimită mai mult de 100 de cereri pe minut per adresă IP. Solicitările care depășesc această limită nu vor fi deservite, iar serviciul nu va fi restabilit timp de 300 de secunde sau până când rata de solicitare scade sub limită, oricare ar fi ulterior. Pentru a limita numărul de solicitări pe care le trimiteți către Connect, NLM recomandă rezultate în cache pentru o perioadă de 12-24 de ore.
Această politică este în vigoare pentru a se asigura că serviciul rămâne disponibil și accesibil tuturor utilizatorilor. Dacă aveți un caz de utilizare specific care vă solicită să trimiteți un număr mare de solicitări către MedlinePlus Connect și, prin urmare, să depășiți limita ratei de solicitare prezentată în această politică, vă rugăm să ne contactați. Personalul NLM vă va evalua solicitarea și va stabili dacă se poate acorda o excepție. Vă rugăm să consultați și documentația fișierelor XML MedlinePlus. Aceste fișiere XML conțin înregistrări tematice complete și pot servi ca o metodă alternativă de accesare a datelor MedlinePlus.