MedlinePlus Connect: Serviciu Web

Conţinut

• Prezentare generală a serviciului web
• Parametrii de ieșire
• Solicitări pentru coduri de diagnosticare (problemă)
• Parametrii opționali
• Descrierea elementelor atomice selectate (sau a obiectelor JSON) ca răspuns la solicitările de cod de problemă
• Exemple de cereri pentru coduri de probleme
• Servicii și fișiere conexe
• Cereri de informații despre droguri
• Parametrii opționali
• Descrierea elementelor atomice selectate (sau a obiectelor JSON) ca răspuns la solicitările de medicație
• Exemple de cereri de coduri de droguri
• Solicitări pentru informații despre testul de laborator
• Parametrii opționali
• Descrierea elementelor atomice selectate (sau a obiectelor JSON) ca răspuns la solicitările de test de laborator
• 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 serviciului Web, care răspunde solicitărilor bazate pe:

Sunteți binevenit (ă) să vă conectați și să afișați datele returnate de MedlinePlus Connect. Nu puteți copia paginile MedlinePlus pe site-ul dvs. Dacă utilizați date de la serviciul Web MedlinePlus Connect, vă rugăm să indicați că informațiile provin de la MedlinePlus.gov, dar nu utilizați sigla MedlinePlus sau implică altfel că MedlinePlus vă susține produsul particular. Vă rugăm să consultați pagina API a NLM pentru îndrumări suplimentare. 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.

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.

Prezentare generală a serviciului web

Parametrii pentru cererile de servicii Web sunt conforme cu Ghidul de implementare bazat pe adresele URL a cererii de cunoștințe HL7 Context-Aware Knowledge Infobutton (Infobutton). Răspunsul bazat pe REST este conform cu Ghidul de implementare a arhitecturii orientate către servicii HL7 Context-Aware Knowledge Retrieval (Infobutton). Ieșirea cererii poate fi XML în formatul de alimentare Atom, JSON sau JSONP.

Structura cererii indică ce tip de cod trimiteți. În toate cazurile, adresa URL de bază pentru serviciul Web este: https://connect.medlineplus.gov/service

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.

Parametrii de ieșire

Acești parametri sunt opționali. Dacă le lăsați în afara, răspunsul implicit este informația în limba engleză în format XML.

Limba
Identificați dacă doriți ca răspunsul 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

Format
Identificați dacă doriți ca formatul de răspuns să fie XML, JSON sau JSONP. XML este valoarea implicită.

Pentru a solicita JSON, utilizați:

knowledgeResponseType = application / json

Pentru JSONP, utilizați:

knowledgeResponseType = application / javascript & callback = CallbackFunction unde CallbackFunction este un nume pe care îl dați funcției de apel invers.

Pentru un răspuns în XML, utilizați:

knowledgeResponseType = text / xml sau lăsați parametrul knowledgeResponseType în afara cererii.

Solicitări pentru coduri de diagnosticare (problemă)

Pentru un cod de problemă, MedlinePlus Connect va returna link-uri și informații de la pagini cu subiecte de sănătate MedlinePlus, pagini de genetică sau pagini de la alte institute NIH.

MedlinePlus Connect va returna următoarele:

Este posibil să nu existe întotdeauna o potrivire pentru fiecare cod. În aceste cazuri, MedlinePlus Connect va returna un răspuns nul.

Adresa URL de bază a serviciului este: https://connect.medlineplus.gov/service

Există doi parametri necesari pentru orice interogare a acestui serviciu:

1. Sistem de cod
   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

2. Cod
   Identificați codul real pe care încercați să îl căutați:
   mainSearchCriteria.v.c = 250.33

Parametrii opționali

Titlul codului
De asemenea, puteți identifica numele / titlul codului problemei. Cu toate acestea, aceste informații nu au impact asupra răspunsului (spre deosebire de aplicația Web MedlinePlus Connect, unde se pot utiliza informațiile despre nume / titlu). mainSearchCriteria.v.dn = Diabetul zaharat cu altă comă de tip 1 necontrolat Consultați secțiunea de mai sus despre Parametrii de ieșire pentru detalii despre limbă și formatele de ieșire.

Descrierea elementelor atomice selectate (sau a obiectelor JSON) ca răspuns la solicitările de cod de problemă

Element	Nodul clasei	Descriere
titlu		Titlul paginii de subiecte de sănătate MedlinePlus sau a paginii GHR potrivite
legătură		Adresa URL pentru pagina de subiect de sănătate MedlinePlus sau pagina GHR potrivită
rezumat		Rezumatul complet pentru tema sănătății. Aceasta include linkuri încorporate către alte subiecte de sănătate relevante și toate formatările, inclusiv gloanțele și spațierea dintre paragrafe. Rezumatul este în HTML. Pentru paginile GHR, este furnizată prima secțiune a paginii complete.
rezumat		Sinonime pentru subiect. Acestea sunt denumite „De asemenea, numite” pe o pagină de subiect de sănătate. Nu toate subiectele au termeni „De asemenea, numiți”.
rezumat		Confirmarea atribuirii pentru textul rezumat, dacă majoritatea rezumatului a fost de la o altă agenție federală. Nu toate rezumatele au o atribuire. Textul neatribuit este original pentru MedlinePlus.
rezumat		Linkuri selectate asociate subiectului. Aceasta include numele paginii, adresa URL și organizația asociată (atunci când este cazul). Link-urile sunt formatate într-o listă cu marcatori. Nu toate subiectele au aceste legături. Numărul de legături poate varia de la zero la zeci.

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/service?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 cu același diagnostic, dar formatul solicitat este JSON și limba este engleza: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Un pacient diagnosticat cu „Pneumonie cauzată de Pseudomonas”, utilizând codul SNOMED CT 41381004: https://connect.medlineplus.gov/service?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

Un pacient cu același diagnostic, dar formatul solicitat este JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=Call

Servicii și fișiere conexe

Pentru a primi subiecte de sănătate MedlinePlus ca răspuns la solicitări de text, spre deosebire de codurile de problemă, investigați serviciul Web MedlinePlus. De asemenea, dacă aveți nevoie de setul complet de subiecte de sănătate MedlinePlus în format XML, consultați pagina noastră de fișiere XML.

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 în engleză sau spaniolă.

Pentru solicitări de informații despre medicamente în limba engleză, dacă nu trimiteți un NDC sau RXCUI sau dacă nu găsim nicio potrivire bazată pe cod, aplicația va utiliza șirul de text pe care îl trimiteți pentru a afișa cea mai bună potrivire cu informații despre medicamente. Pentru solicitările de informații despre medicamente în Spania, MedlinePlus Connect răspunde doar la NDC-uri sau RXCUIs și nu folosește șiruri de text. Este posibil să aveți o răspuns în engleză, dar niciun răspuns în spaniolă.

Serviciul Web MedlinePlus Connect va returna următoarele:

Ar putea exista răspunsuri multiple la o solicitare de medicamente. Este posibil să nu existe întotdeauna o potrivire pentru fiecare solicitare. În aceste cazuri, MedlinePlus Connect va returna un răspuns nul.

Pentru solicitările de informații despre medicamente, adresa URL de bază este: https://connect.medlineplus.gov/service

Pentru a trimite o solicitare, includeți aceste informații:

1. Sistem de cod
   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

   MedlinePlus Connect poate accepta, de asemenea, un șir de text pentru solicitările de informații despre medicamente în limba engleză, dar trebuie să indicați că sunteți în căutarea informațiilor despre medicamente, incluzând unul dintre cele două sisteme de cod enumerate mai sus.
2. Cod
   Identificați codul real pe care încercați să îl căutați. (Preferat pentru engleză, obligatoriu pentru spaniolă)
   mainSearchCriteria.v.c = 637188
3. Numele medicamentului
   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

Cel puțin trebuie să identificați 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ă. Trimiteți sistemul de coduri și codul pentru solicitările spaniole.

Parametrii opționali

Titlul codului

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. mainSearchCriteria.v.dn = Tabletă orală Chantix 0,5 MG

Consultați secțiunea de mai sus despre Parametrii de ieșire pentru detalii despre limbă și formatele de ieșire.

Descrierea elementelor atomice selectate (sau a obiectelor JSON) ca răspuns la solicitările de medicație

Element	Descriere
titlu	Titlu pentru pagina de medicamente MedlinePlus potrivită
legătură	Adresa URL pentru pagina de medicamente MedlinePlus potrivită
autor	Atribuirea sursei pentru informații despre medicamente

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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=637188&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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-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 solicitările în limba engleză. Solicitarea dvs. ar putea arăta astfel: 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 = 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. Serviciul poate oferi un răspuns în engleză sau spaniolă.

Serviciul Web MedlinePlus Connect va returna următoarele:

Este posibil să nu existe întotdeauna o potrivire pentru fiecare cod. În aceste cazuri, MedlinePlus Connect va returna un răspuns nul.

Adresa URL de bază a serviciului este: https://connect.medlineplus.gov/service

Aceștia sunt doi parametri necesari pentru orice interogare de test de laborator la acest serviciu:

1. Sistem de cod
   

   Identificați că utilizați sistemul de cod LOINC. Utilizare:

   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

2. Cod
   identificați codul real pe care încercați să îl căutați:
   mainSearchCriteria.v.c = 3187-2

Parametrii opționali

Titlul codului

De asemenea, puteți identifica numele testului de laborator. Cu toate acestea, aceste informații nu au impact asupra răspunsului. mainSearchCriteria.v.dn = Testul factorului IX

Consultați secțiunea de mai sus despre Parametrii de ieșire pentru detalii despre limbă și formatele de ieșire.

Descrierea elementelor atomice selectate (sau a obiectelor JSON) ca răspuns la solicitările de test de laborator

Element	Descriere
titlu	Titlul paginii de test de laborator MedlinePlus potrivite
legătură	Adresa URL pentru pagina de test de laborator MedlinePlus potrivită
rezumat	Fragment din conținutul paginii
autor	Atribuirea sursei pentru conținutul testului de laborator

Exemple de cereri de teste de laborator

Pentru a solicita informații pentru un vorbitor de limbă engleză, solicitarea dvs. poate arăta ca una dintre următoarele: 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.languageCode.c = ro

Pentru a solicita informații pentru un vorbitor de limbă spaniolă, solicitarea dvs. poate arăta ca una dintre următoarele: 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.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.

Mai multe informatii