MedlinePlus Connect: applicazione web
Contenuto
- Panoramica dell'applicazione Web
- Richieste di codici di diagnosi (problema)
- Parametri opzionali
- Esempi di richieste di codici problema
- Richieste di informazioni sui farmaci
- Parametri opzionali
- Esempi di richieste di codici farmaco
- Richieste di informazioni sui test di laboratorio
- Parametri opzionali
- Esempi di richieste di test di laboratorio
- Politica di utilizzo accettabile
- Maggiori informazioni
MedlinePlus Connect è disponibile come applicazione Web o servizio Web. Di seguito i dettagli tecnici per l'implementazione dell'applicazione Web, che risponde alle richieste in base a:
Se decidi di utilizzare MedlinePlus Connect, iscriviti all'elenco e-mail per tenere il passo con gli sviluppi e scambiare idee con i tuoi colleghi. Comunicaci se implementi MedlinePlus Connect contattandoci. Puoi collegarti e visualizzare i dati forniti da MedlinePlus Connect. Per ulteriori informazioni su come collegarsi a contenuti MedlinePlus al di fuori di questo servizio, consultare le nostre linee guida e istruzioni sul collegamento.
Panoramica dell'applicazione Web
L'API per l'applicazione Web è conforme alla specifica HL7 Context-Aware Knowledge Retrieval (Infobutton) Richiesta di conoscenza basata su URL. La struttura della richiesta indica che tipo di codice stai inviando. In tutti i casi, l'URL di base per l'applicazione Web è: https://connect.medlineplus.gov/application
MedlinePlus Connect utilizza connessioni HTTPS. Le richieste HTTP non verranno accettate e le implementazioni esistenti che utilizzano HTTP dovrebbero essere aggiornate a HTTPS.
Richieste di codici di diagnosi (problema)
MedlinePlus Connect abbina i codici ICD-10-CM, ICD-9-CM o SNOMED CT alle pagine di argomenti sanitari di MedlinePlus, alle pagine di genetica o alle pagine di altri istituti NIH. Ad esempio, a un paziente con diagnosi di codice ICD-9-CM 493.12, Asma estrinseco con esacerbazione, potrebbe essere presentato un collegamento in una cartella clinica elettronica (EHR) che conduce alla pagina Asma di MedlinePlus.
Per le richieste per problema, l'URL di base dell'applicazione è: https://connect.medlineplus.gov/applicationQuesto collegamento visualizza una pagina con una casella di ricerca vuota. Ci sono due parametri obbligatori per qualsiasi query a questa applicazione:
- Identifica il sistema di codici problema che utilizzerai.
- Per l'utilizzo dell'ICD-10-CM:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.90
- Per l'utilizzo di ICD-9-CM:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.103
- Per l'uso della TC SNOMED:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.96
- Identifica il codice effettivo che stai cercando di cercare:
mainSearchCriteria.v.c=250.33
Parametri opzionali
Identificare il nome/titolo del codice problema. L'invio di nessun codice risulterà in una query al motore di ricerca MedlinePlus. Se specifichi un codice e il nome/titolo del codice, ma MedlinePlus Connect non ha risultati, la pagina di risposta visualizzerà una casella di ricerca MedlinePlus precompilata con il nome/titolo. mainSearchCriteria.v.dn=Diabete mellito con altro coma di tipo 1 non controllato
Identifica se desideri che la richiesta sia in inglese o spagnolo. MedlinePlus Connect presumerà che l'inglese sia la lingua se non è specificato.
Se desideri che la risposta alla ricerca del codice del problema sia in spagnolo, usa: informationRecipient.languageCode.c=es
(=sp anche accettato)
Per specificare l'inglese, utilizzare quanto segue: informationRecipient.languageCode.c=en
Esempi di richieste di codici problema
Una richiesta completa per Diabete Mellito con altro coma di tipo 1 non controllato, codice ICD-9 250.33, per un paziente di lingua spagnola avrebbe il seguente indirizzo 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%20with%20other%20coma%20type%201%20uncontrollato&informationRecipient.languageCode.c=es
Un paziente con diagnosi di "polmonite dovuta a Pseudomonas" utilizzando il codice SNOMED CT 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Polmonite%20due%20to%20Pseudomonas%20%28disorder%29&informationRecipient.languageCode.c=it
Una query in formato libero, senza sistema di codice o codice problema, utilizzerà il motore di ricerca MedlinePlus (solo in inglese): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
Richieste di informazioni sui farmaci
MedlinePlus Connect fornisce le migliori corrispondenze di informazioni sui farmaci quando si riceve un RXCUI. Fornisce anche buoni risultati quando si riceve un codice NDC. MedlinePlus Connect può fornire risposte alle richieste di codici farmaco in inglese o spagnolo e restituirà un collegamento a una pagina dei risultati con le migliori corrispondenze dalle informazioni sui farmaci MedlinePlus.
Per le richieste di informazioni sui farmaci in inglese, se non si invia un codice NDC o RXCUI o se non troviamo alcuna corrispondenza in base al codice, utilizzeremo la stringa di testo inviata per visualizzare la migliore corrispondenza delle informazioni sul farmaco. Per le richieste di informazioni sui farmaci spagnoli, MedlinePlus Connect risponde solo a NDC o RXCUI; non usa stringhe di testo. È possibile avere una risposta in inglese ma nessuna risposta in spagnolo.
Ci possono essere più risposte a una richiesta di farmaco. Potrebbe non esserci sempre una corrispondenza per ogni richiesta. Se MedlinePlus Connect trova una risposta nulla per una richiesta di farmaco, il programma visualizza una casella di ricerca per il sito MedlinePlus. Un utente può digitare il nome di un farmaco e ottenere una buona risposta.
Per le richieste di informazioni sui farmaci, l'URL di base è: https://connect.medlineplus.gov/application
Le richieste di informazioni sui farmaci in inglese e spagnolo hanno requisiti diversi. Per inviare una richiesta, includi queste informazioni:
- Identifica il tipo di codice del farmaco che stai inviando. (Obbligatorio per inglese e spagnolo)
- Per l'uso di RXCUI:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.88
- Per uso NDC:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.69
- Identifica il codice effettivo che stai cercando di cercare. (Preferito per l'inglese, obbligatorio per lo spagnolo)
mainSearchCriteria.v.c=637188 - Identificare il nome del farmaco con una stringa di testo. (Facoltativo per l'inglese, non utilizzato per lo spagnolo)
mainSearchCriteria.v.dn=Chantix 0,5 mg compressa orale
Per le richieste in inglese, dovresti identificare come minimo il sistema di codici e il codice, o il sistema di codici e il nome del farmaco. Invia tutti e tre per ottenere i migliori risultati per le richieste in inglese. Per le richieste in spagnolo, è necessario identificare il sistema di codici e il codice.
Parametri opzionali
Quando si invia una richiesta di informazioni in inglese, è possibile includere il parametro facoltativo del nome del farmaco. Questo è dettagliato nella sezione precedente. Questo parametro non viene utilizzato per le richieste in spagnolo.
Identifica se desideri che la richiesta sia in inglese o spagnolo. MedlinePlus Connect presumerà che l'inglese sia la lingua se non è specificato.
Se desideri che la risposta alla ricerca del codice farmaco sia in spagnolo, usa: informationRecipient.languageCode.c=es (=sp anche accettato)
Per specificare l'inglese, utilizzare quanto segue: informationRecipient.languageCode.c=en
Esempi di richieste di codici farmaco
La tua richiesta di informazioni sul farmaco dovrebbe essere simile a una delle seguenti.
Per richiedere informazioni a un RXCUI, la tua richiesta dovrebbe essere simile a questa: 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=it
Per richiedere informazioni a un NDC per un parlante spagnolo, la tua richiesta dovrebbe essere simile a questa: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39&informationRecipient.languageCode.c=es
Per inviare una stringa di testo senza un codice farmaco, devi identificare la tua richiesta come una richiesta di tipo NDC in modo che MedlinePlus Connect sappia che stai cercando informazioni sui farmaci. Funzionerà solo per l'inglese. La tua richiesta potrebbe essere simile a questa: 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
Richieste di informazioni sui test di laboratorio
MedlinePlus Connect fornisce corrispondenze alle informazioni sui test di laboratorio quando si riceve una richiesta LOINC. MedlinePlus Connect può fornire risposte alle richieste di test di laboratorio in inglese o spagnolo e restituirà un collegamento a una pagina dei risultati con le migliori corrispondenze dalle informazioni sui test di laboratorio MedlinePlus.
Per le richieste di informazioni sui test di laboratorio, l'URL di base è: https://connect.medlineplus.gov/application
Questi sono due parametri obbligatori per qualsiasi query di test di laboratorio a questa applicazione:
- Identifica che stai utilizzando il sistema di codici LOINC.
- Per LOINC utilizzare:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.1
- MedlinePlus Connect accetterà anche:
- mainSearchCriteria.v.cs=2.16.840.1.113883.11.79
- Identifica il codice effettivo che stai cercando di cercare.
mainSearchCriteria.v.c=3187-2
Parametri opzionali
Identificare il nome/titolo del test di laboratorio. Tuttavia, queste informazioni non influiscono sulla risposta. mainSearchCriteria.v.dn=Saggio del fattore IX
Identifica se desideri che la richiesta sia in inglese o spagnolo. MedlinePlus Connect presumerà che l'inglese sia la lingua se non è specificato.
Se desideri che la risposta alla ricerca del codice del problema sia in spagnolo, usa: informationRecipient.languageCode.c=es (=sp anche accettato)
Per specificare l'inglese, utilizzare quanto segue: informationRecipient.languageCode.c=en
Una query a mano libera, senza sistema di codice o codice di laboratorio, utilizzerà il motore di ricerca MedlinePlus. Questo approccio è più efficace con le diagnosi (vedere le informazioni sul codice del problema sopra) invece delle stringhe di testo dei test di laboratorio. La tua richiesta di informazioni sui test di laboratorio dovrebbe essere simile a una delle seguenti.
Esempi di richieste di test di laboratorio
Per richiedere informazioni per un anglofono, la tua richiesta potrebbe essere una delle seguenti: 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 =en
Per richiedere informazioni per un madrelingua spagnolo, la tua richiesta potrebbe essere una delle seguenti: 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 di utilizzo accettabile
Per evitare di sovraccaricare i server MedlinePlus, NLM richiede che gli utenti di MedlinePlus Connect inviino non più di 100 richieste al minuto per indirizzo IP. Le richieste che superano questo limite non verranno soddisfatte e il servizio non verrà ripristinato per 300 secondi o finché la velocità di richiesta non scenderà al di sotto del limite, a seconda dell'evento che si verifica dopo. Per limitare il numero di richieste inviate a Connect, NLM consiglia di memorizzare nella cache i risultati per un periodo di 12-24 ore.
Questa politica è in atto per garantire che il servizio rimanga disponibile e accessibile a tutti gli utenti. Se hai un caso d'uso specifico che richiede di inviare un numero elevato di richieste a MedlinePlus Connect e quindi superare il limite di frequenza delle richieste delineato in questa politica, ti preghiamo di contattarci. Lo staff di NLM valuterà la tua richiesta e determinerà se può essere concessa un'eccezione. Si prega di rivedere anche la documentazione dei file XML di MedlinePlus. Questi file XML contengono record di argomenti sanitari completi e possono servire come metodo alternativo per accedere ai dati MedlinePlus.