MedlinePlus Connect: Serviziu Web
Cuntenutu
- Panoramica di u Serviziu Web
- Parametri di Risultatu
- Richieste di Codici di Diagnosticu (Problem)
- Parametri Opzionali
- Descrizione di Elementi Atomici Scelti (o oggetti JSON) in Risposta à e Richieste di Codice di Problema
- Esempii di Dumande per Codici di Problema
- Servizi è File Relativi
- Richieste di Infurmazione nantu à a Droga
- Parametri Opzionali
- Descrizione di Elementi Atomici Scelti (o oggetti JSON) in Risposta à e Richieste di Medicazione
- Esempii di Dumande per Codici di Droga
- Richieste di Infurmazione di Test di Lab
- Parametri Opzionali
- Descrizione di Elementi Atomici Scelti (o oggetti JSON) in Risposta à e Richieste di Test di Lab
- Esempii di Richieste per Prove di Laboratoriu
- Politica d'Utilizazione Accettabile
- Più infurmazione
MedlinePlus Connect hè dispunibule cum'è applicazione Web o serviziu Web. Di seguito sò i dettagli tecnichi per l'implementazione di u serviziu Web, chì risponde à e richieste basate annantu à:
Sò invitati à ligà è visualizà i dati restituiti da MedlinePlus Connect. Ùn pudete micca cupià e pagine MedlinePlus nantu à u vostru situ. Se utilizate dati da u Serviziu Web Connect MedlinePlus, per piacè indicate chì l'infurmazioni sò di MedlinePlus.gov ma ùn aduprate micca u logu MedlinePlus o altrimenti implicanu chì MedlinePlus approva u vostru pruduttu particulare. Per piacè vede a pagina API di NLM per più guida. Per saperne di più infurmazioni nantu à cume ligà cun cuntenutu MedlinePlus fora di stu serviziu, per piacè vedi e nostre linee guida è istruzzioni nantu à a leia.
Se decidite di aduprà MedlinePlus Connect, iscriviti à a lista di e-mail per tene u ritornu cù l'evoluzione è scambià idee cù i vostri cumpagni. Diteci se implementate MedlinePlus Connect cuntattendu ci.
Panoramica di u Serviziu Web
I parametri per e richieste di servizii Web sò conformi à a Recuperazione di cunniscenze HL7 Context-Aware (Infobutton) Richiesta di cunniscenza Guida d'implementazione basata in URL. A risposta basata nantu à REST hè conforme à u Recuperu di cunniscenze HL7-Conware-Aware (Infobutton) Guida di Implementazione di l'Architettura Orientata à u Serviziu. L'output di a dumanda pò esse XML in u formatu di feed Atom, JSON, o JSONP.
A struttura di a dumanda indica chì tippu di codice inviate. In tutti i casi, l'URL di basa per u serviziu Web hè: https://connect.medlineplus.gov/service
MedlinePlus Connect utilizza cunnessione HTTPS. E richieste HTTP ùn saranu micca accettate è l'implementazioni esistenti chì utilizanu HTTP devenu aghjurnà à HTTPS.
Parametri di Risultatu
Questi parametri sò facoltativi. Se i lasciate fora, a risposta predefinita hè l'infurmazione inglese in furmatu XML.
Lingua
Identificate se vulete chì a risposta sia in inglese o spagnolu. MedlinePlus Connect assumerà chì l'inglese hè a lingua se ùn hè micca specificata.
Se vulete chì a risposta à a ricerca di i codici di prublemi sia in spagnolu, aduprate: informationRecipient.languageCode.c = es
(= sp hè ancu accettatu)
Per specificà l'inglese, aduprate i seguenti: informationRecipient.languageCode.c = en
Format
Identificate se vulete chì u furmatu di risposta sia XML, JSON o JSONP. XML hè u default.
- Per dumandà JSON, aduprate:
- knowledgeResponseType = application / json
- Per JSONP, aduprate:
- knowledgeResponseType = application / javascript & callback = Funzione Callback induve Funzione Callback hè un nome chì li date à a funzione di richiamata.
- Per una risposta in XML, aduprate:
- knowledgeResponseType = text / xml o lasciate u paràmetru knowledgeResponseType fora di a dumanda.
Richieste di Codici di Diagnosticu (Problem)
Per un codice di prublema, MedlinePlus Connect restituverà ligami è informazioni da e pagine di sughjettu di salute MedlinePlus, pagine di genetica, o pagine da altri Istituti NIH.
MedlinePlus Connect restituverà i seguenti:
Ùn ci pò micca sempre esse una partita per ogni codice. In questi casi, MedlinePlus Connect restituverà una risposta nulla.
L'URL di basa di u serviziu hè: https://connect.medlineplus.gov/service
Ci hè dui parametri richiesti per ogni dumanda à stu serviziu:
- Sistema di Codice
Identificate u sistema di codice di prublema chì avete da aduprà.- Per l'usu ICD-10-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- Per l'usu ICD-9-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- Per l'usu SNOMED CT:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Codice
Identificate u codice attuale chì pruvate à circà:
mainSearchCriteria.v.c = 250.33
Parametri Opzionali
Titulu di u Codice
Pudete ancu identificà u nome / titulu di u codice di prublema. Tuttavia, queste informazioni ùn influenzanu micca a risposta (à u cuntrariu di l'applicazione Web Connect MedlinePlus induve l'infurmazioni di u nome / titulu ponu esse aduprate). mainSearchCriteria.v.dn = Diabetes mellitus cù altre coma di tippu 1 incontrollatu Vede a sezione sopra à Parametri di Risultatu per i dettagli nantu à a lingua è i furmati di surtita.
Descrizione di Elementi Atomici Scelti (o oggetti JSON) in Risposta à e Richieste di Codice di Problema
| Elementu | Node di classe | Description |
|---|---|---|
| titulu | Titulu di a pagina di tema di salute MedlinePlus abbinata o pagina GHR | |
| ligame | URL per a pagina di tema di salute MedlinePlus o pagina GHR abbinata | |
| riassuntu | U riassuntu cumpletu per u tema di salute. Ciò include ligami incrustati à altri temi di salute pertinenti, è tutte e formattazioni, cumprese i proiettili è a spaziatura di i paragrafi. U riassuntu hè in HTML. Per e pagine GHR, a prima sezione di a pagina completa hè furnita. | |
| riassuntu | Sinonimi per u tema. Quessi sò chjamati "Ancu chjamati" in una pagina di tema di salute. Micca tutti l'argumenti anu termini "Ancu chjamati". | |
| riassuntu | Ricunniscenza di attribuzione per u testu di riassuntu, se a maggior parte di u riassuntu era da un'altra agenza federale. Micca tutti i riassunti anu una attribuzione. U testu senza attribuzione hè uriginale di MedlinePlus. | |
| riassuntu | Ligami selezziunati assuciati à u tema. Ciò include u nome di a pagina, l'URL è l'organizazione associata (quandu applicabile). I ligami sò furmattati in una lista à bulette. Micca tutti i sughjetti anu sti ligami. U numaru di ligami pò varià da zeru à decine. |
Esempii di Dumande per Codici di Problema
Una dumanda cumpleta di Diabetes Mellitus cù un altru tipu di coma 1 incontrollatu, codice ICD-9 250.33, per un paziente di lingua spagnola averia u seguente indirizzu URL: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabete% 20mellitus% 20con% 20other% 20coma% 20type% 201% 20uncontrolled & informationRecipient.languageCode.c = es
Un paziente cù a stessa diagnosi ma u furmatu dumandatu hè JSON è a lingua hè Inglese: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json
Un paziente diagnosticatu di "Pneumonia per Pseudomonas" cù u codice 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 = en
Un paziente cù a stessa diagnosi ma u furmatu dumandatu hè 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
Servizi è File Relativi
Per riceve temi di salute MedlinePlus in risposta à e dumande di testu, à u cuntrariu di i codici di prublemi, investigate u serviziu Web MedlinePlus. Inoltre, se avete bisognu di l'inseme di l'argumenti di salute MedlinePlus in furmatu XML, vedi a nostra pagina di fugliali XML.
Richieste di Infurmazione nantu à a Droga
MedlinePlus Connect furnisce i migliori partiti d'infurmazione di droghe quandu riceve un RXCUI. Fornisce ancu boni risultati quandu riceve un codice NDC. MedlinePlus Connect pò furnisce risposte in inglese o spagnolu.
Per e richieste d'infurmazioni in inglese di medicazione, se ùn mandate micca un NDC o RXCUI o se ùn truvemu nisuna corrispondenza basata nantu à u codice, l'applicazione utilizerà a stringa di testu chì inviate per visualizà a migliore partita d'infurmazione nantu à a droga. Per e richieste d'infurmazioni medicinali spagnoli, MedlinePlus Connect risponde solu à NDC o RXCUIs è ùn usa micca stringhe di testu. Hè pussibule avè una risposta in inglese ma nisuna risposta in spagnolu.
U serviziu Web MedlinePlus Connect restituverà i seguenti:
Puderia esse risposte multiple à una dumanda di medicazione. Ùn pò micca sempre esse un match per ogni dumanda. In questi casi, MedlinePlus Connect restituverà una risposta nulla.
Per e richieste di informazioni nantu à a droga, l'URL di basa hè: https://connect.medlineplus.gov/service
Per invià una richiesta, includite queste informazioni:
- Sistema di Codice
Identificate u tipu di codice di medicazione chì inviate. (Obbligatoriu per Inglese è Spagnolu)- Per l'usu RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Per l'usu NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Codice
Identificate u codice attuale chì pruvate à circà. (Preferitu per Inglese, Richiestu per Spagnolu)
mainSearchCriteria.v.c = 637188 - Nome di a droga
Identificate u nome di a droga cù una stringa di testu. (Facultativu per Inglese, Micca adupratu per Spagnolu)
mainSearchCriteria.v.dn = Compressa Orale Chantix 0,5 MG
Parametri Opzionali
Titulu di u CodiceQuandu inviate una richiesta d'infurmazioni in Inglese, pudete include u parametru opzionale di u nome di u medicamentu. Questu hè dettagliatu in a sezione sopra. mainSearchCriteria.v.dn = Compressa Orale Chantix 0,5 MG
Vede a sezione sopra à Parametri di Risultatu per i dettagli nantu à a lingua è i formati di uscita.
Descrizione di Elementi Atomici Scelti (o oggetti JSON) in Risposta à e Richieste di Medicazione
| Elementu | Description |
|---|---|
| titulu | Titulu per a pagina di medicazione MedlinePlus abbinata |
| ligame | URL per a pagina di medicazione MedlinePlus abbinata |
| autore | Attribuzione di fonte per l'infurmazioni di medicazione |
Esempii di Dumande per Codici di Droga
A vostra dumanda d'infurmazione di medicazione duverebbe sembrà una di e seguenti.
Per dumandà l'infurmazioni da un RXCUI, a vostra dumanda duveria esse cusì: 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 = fr
Per dumandà l'infurmazioni da un NDC per un parlante spagnolu, a vostra dumanda duveria esse cusì: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es
Per invià una stringa di testu senza un codice di medicazione, duvete identificà a vostra dumanda cum'è una richiesta di tippu NDC per chì MedlinePlus Connect sappia chì state cercendu informazioni nantu à i medicamenti. Questu funziona solu per e richieste in inglese. A vostra dumanda pò esse simile: 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 = fr
Richieste di Infurmazione di Test di Lab
MedlinePlus Connect furnisce partite per l'infurmazioni di test di laboratorio quandu riceve una richiesta LOINC. U serviziu pò furnisce una risposta in Inglese o Spagnolu.
U serviziu Web MedlinePlus Connect restituverà i seguenti:
Ùn ci pò micca sempre esse una partita per ogni codice. In questi casi, MedlinePlus Connect restituverà una risposta nulla.
L'URL di basa di u serviziu hè: https://connect.medlineplus.gov/service
Si tratta di dui parametri richiesti per ogni dumanda di prova di laboratorio in stu serviziu:
- Sistema di Codice
- Identificate chì state aduprendu u sistema di codici LOINC. Aduprà:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect accetterà ancu:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Codice
identificà u codice attuale chì pruvate à circà:
mainSearchCriteria.v.c = 3187-2
Parametri Opzionali
Titulu di u CodicePudete ancu identificà u nome di u test di laboratorio. Tuttavia, sta infurmazione ùn hà micca impattu in a risposta. mainSearchCriteria.v.dn = Assay di Fattore IX
Vede a sezione sopra à Parametri di Risultatu per i dettagli nantu à a lingua è i furmati di uscita
Descrizione di Elementi Atomici Scelti (o oggetti JSON) in Risposta à e Richieste di Test di Lab
| Elementu | Description |
|---|---|
| titulu | Titulu di a pagina di test di laburatoriu MedlinePlus abbinata |
| ligame | URL per a pagina di test di laburatoriu MedlinePlus abbinata |
| riassuntu | Snippet da u cuntenutu di a pagina |
| autore | Attribuzione di fonte per u cuntenutu di test di laboratorio |
Esempii di Richieste per Prove di Laboratoriu
Per dumandà l'infurmazioni per un parlante inglese, a vostra dumanda pò sembrà una di e seguenti: 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 = fr
Per dumandà l'infurmazioni per un parlante spagnolu, a vostra dumanda pò sembrà una di e seguenti: 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 d'Utilizazione Accettabile
Per evità di sovraccaricà i servitori MedlinePlus, NLM richiede chì l'utenti di MedlinePlus Connect inviate micca più di 100 richieste per minutu per indirizzu IP. E richieste chì superanu stu limitu ùn seranu micca servite, è u serviziu ùn serà micca ristabilitu per 300 secondi o finu à chì a tarifa di dumanda scende sottu u limitu, quellu chì vene dopu. Per limità u numeru di richieste chì mandate à Connect, NLM raccomanda risultati in cache per un periodu di 12-24 ore.
Sta pulitica hè in opera per assicurà chì u serviziu sia dispunibile è accessibile à tutti l'utenti. Se avete un casu d'usu specificu chì richiede di invià un gran numeru di richieste à MedlinePlus Connect, è cusì supera u limitu di percentuale di richieste spiegatu in questa pulitica, cuntattateci. U persunale NLM valuterà a vostra richiesta è determinerà se una eccezione pò esse accordata. Per piacè, rivedi a documentazione di i file XML MedlinePlus. Questi fugliali XML cuntenenu registri tematichi cumpleti di salute è ponu serve cum'è un metudu alternativu per accede à i dati MedlinePlus.
Più infurmazione
Oghje Populu
Cumu aduprà Centella Asiatica per perde u pesu
