MedlinePlus Connect: servizio Web

Contenuto

• Panoramica del servizio Web
• Parametri di uscita
• Richieste di codici di diagnosi (problema)
• Parametri opzionali
• Descrizione degli elementi Atom selezionati (o oggetti JSON) in risposta alle richieste di codice problema
• Esempi di richieste di codici problema
• Servizi e file correlati
• Richieste di informazioni sui farmaci
• Parametri opzionali
• Descrizione degli elementi Atom selezionati (o oggetti JSON) in risposta alle richieste di farmaci
• Esempi di richieste di codici farmaco
• Richieste di informazioni sui test di laboratorio
• Parametri opzionali
• Descrizione degli elementi Atom selezionati (o oggetti JSON) in risposta alle richieste di test di laboratorio
• 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 del servizio Web, che risponde alle richieste in base a:

Puoi collegarti e visualizzare i dati restituiti da MedlinePlus Connect. Non puoi copiare le pagine di MedlinePlus sul tuo sito. Se si utilizzano i dati del servizio Web MedlinePlus Connect, indicare che le informazioni provengono da MedlinePlus.gov ma non utilizzare il logo MedlinePlus o implicare in altro modo che MedlinePlus approvi il prodotto specifico. Si prega di consultare la pagina API di NLM per ulteriori indicazioni. Per ulteriori informazioni su come collegarsi a contenuti MedlinePlus al di fuori di questo servizio, consultare le nostre linee guida e istruzioni sul collegamento.

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.

Panoramica del servizio Web

I parametri per le richieste del servizio Web sono conformi alla Guida all'implementazione basata su URL di richiesta di informazioni basata su URL HL7. La risposta basata su REST è conforme alla Guida all'implementazione dell'architettura orientata ai servizi HL7 Context-Aware Knowledge Retrieval (Infobutton). L'output della richiesta può essere XML nel formato feed Atom, JSON o JSONP.

La struttura della richiesta indica che tipo di codice stai inviando. In tutti i casi, l'URL di base per il servizio Web è: https://connect.medlineplus.gov/service

MedlinePlus Connect utilizza connessioni HTTPS. Le richieste HTTP non verranno accettate e le implementazioni esistenti che utilizzano HTTP dovrebbero essere aggiornate a HTTPS.

Parametri di uscita

Questi parametri sono facoltativi. Se li tralasci, la risposta predefinita sono le informazioni in inglese in formato XML.

linguaggio
Identifica se desideri che la risposta 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

Formato
Identifica se desideri che il formato della risposta sia XML, JSON o JSONP. XML è l'impostazione predefinita.

Per richiedere JSON, utilizzare:

knowledgeResponseType=applicazione/json

Per JSONP, usa:

knowledgeResponseType=application/javascript&callback=CallbackFunction dove CallbackFunction è un nome assegnato alla funzione di richiamata.

Per una risposta in XML, usa:

knowledgeResponseType=text/xml o lasciare il parametro knowledgeResponseType fuori dalla richiesta.

Richieste di codici di diagnosi (problema)

Per un codice problema, MedlinePlus Connect restituirà collegamenti e informazioni da pagine di argomenti sanitari MedlinePlus, pagine di genetica o pagine di altri istituti NIH.

MedlinePlus Connect restituirà quanto segue:

Potrebbe non esserci sempre una corrispondenza per ogni codice. In questi casi, MedlinePlus Connect restituirà una risposta nulla.

L'URL di base del servizio è: https://connect.medlineplus.gov/service

Esistono due parametri obbligatori per qualsiasi query a questo servizio:

1. Sistema di codice
   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

2. Codice
   Identifica il codice effettivo che stai cercando di cercare:
   mainSearchCriteria.v.c=250.33

Parametri opzionali

Codice Titolo
È inoltre possibile identificare il nome/titolo del codice problema. Tuttavia, queste informazioni non influiscono sulla risposta (a differenza dell'applicazione Web MedlinePlus Connect in cui è possibile utilizzare le informazioni sul nome/titolo). mainSearchCriteria.v.dn=Diabete mellito con altro coma di tipo 1 non controllato Vedere la sezione precedente sui parametri di output per i dettagli sulla lingua e sui formati di output.

Descrizione degli elementi Atom selezionati (o oggetti JSON) in risposta alle richieste di codice problema

Elemento	Nodo di classe	Descrizione
titolo		Titolo della pagina relativa all'argomento salute MedlinePlus o alla pagina GHR
collegamento		URL per la pagina relativa all'argomento salute MedlinePlus o alla pagina GHR
sommario		Il riassunto completo per l'argomento salute. Ciò include collegamenti incorporati ad altri argomenti sanitari rilevanti e tutta la formattazione, inclusi punti elenco e spaziatura dei paragrafi. Il riassunto è in HTML. Per le pagine GHR, viene fornita la prima sezione della pagina intera.
sommario		Sinonimi per l'argomento. Questi sono indicati come "chiamati anche" in una pagina di argomento sanitario. Non tutti gli argomenti hanno termini "chiamati anche".
sommario		Riconoscimento di attribuzione per il testo riassuntivo, se la maggior parte del riassunto proviene da un'altra agenzia federale Non tutti i riepiloghi hanno un'attribuzione. Il testo non attribuito è originale di MedlinePlus.
sommario		Link selezionati associati all'argomento. Ciò include il nome della pagina, l'URL e l'organizzazione associata (se applicabile). I collegamenti sono formattati in un elenco puntato. Non tutti gli argomenti hanno questi collegamenti. Il numero di collegamenti può variare da zero a dozzine.

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/service?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 la stessa diagnosi ma il formato richiesto è JSON e la lingua è l'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 con diagnosi di "polmonite dovuta a Pseudomonas" utilizzando il codice SNOMED CT 41381004: https://connect.medlineplus.gov/service?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

Un paziente con la stessa diagnosi ma il formato richiesto è JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFunction

Servizi e file correlati

Per ricevere argomenti sanitari MedlinePlus in risposta a richieste di testo, anziché codici problema, indagare sul servizio Web MedlinePlus. Inoltre, se hai bisogno del set completo di argomenti sulla salute di MedlinePlus in formato XML, consulta la nostra pagina dei file XML.

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 in inglese o spagnolo.

Per le richieste di informazioni sui farmaci in inglese, se non si invia un NDC o RXCUI o se non troviamo alcuna corrispondenza in base al codice, l'applicazione utilizzerà 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 e non utilizza stringhe di testo. È possibile avere una risposta in inglese ma nessuna risposta in spagnolo.

Il servizio Web MedlinePlus Connect restituirà quanto segue:

Potrebbero esserci più risposte a una richiesta di farmaco. Potrebbe non esserci sempre una corrispondenza per ogni richiesta. In questi casi, MedlinePlus Connect restituirà una risposta nulla.

Per le richieste di informazioni sui farmaci, l'URL di base è: https://connect.medlineplus.gov/service

Per inviare una richiesta, includi queste informazioni:

1. Sistema di codice
   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

   MedlinePlus Connect può anche accettare una stringa di testo per le richieste di informazioni sui farmaci in inglese, ma devi indicare che stai cercando informazioni sui farmaci includendo uno dei due sistemi di codici sopra elencati.
2. Codice
   Identifica il codice effettivo che stai cercando di cercare. (Preferito per l'inglese, obbligatorio per lo spagnolo)
   mainSearchCriteria.v.c=637188
3. Nome del farmaco
   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

Come minimo dovresti identificare 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. Invia il sistema di codice e il codice per le richieste spagnole.

Parametri opzionali

Codice Titolo

Quando si invia una richiesta di informazioni in inglese, è possibile includere il parametro facoltativo del nome del farmaco. Questo è dettagliato nella sezione precedente. mainSearchCriteria.v.dn=Chantix 0,5 mg compressa orale

Vedere la sezione precedente sui parametri di output per i dettagli sulla lingua e sui formati di output.

Descrizione degli elementi Atom selezionati (o oggetti JSON) in risposta alle richieste di farmaci

Elemento	Descrizione
titolo	Titolo per la pagina dei farmaci MedlinePlus abbinati
collegamento	URL per la pagina del farmaco MedlinePlus corrispondente
autore	Attribuzione della fonte per le informazioni sui farmaci

Esempi di richieste di codici farmaco

La tua richiesta di informazioni sui farmaci dovrebbe essere simile a una delle seguenti.

Per richiedere informazioni da un RXCUI, la tua richiesta dovrebbe essere simile a questa: 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=it

Per richiedere informazioni a un NDC per un parlante spagnolo, la tua richiesta dovrebbe essere simile a questa: 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 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 le richieste in inglese. La tua richiesta potrebbe essere simile a questa: 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 =en

Richieste di informazioni sui test di laboratorio

MedlinePlus Connect fornisce corrispondenze alle informazioni sui test di laboratorio quando si riceve una richiesta LOINC. Il servizio può fornire una risposta in inglese o spagnolo.

Il servizio Web MedlinePlus Connect restituirà quanto segue:

Potrebbe non esserci sempre una corrispondenza per ogni codice. In questi casi, MedlinePlus Connect restituirà una risposta nulla.

L'URL di base del servizio è: https://connect.medlineplus.gov/service

Questi sono due parametri obbligatori per qualsiasi query di test di laboratorio a questo servizio:

1. Sistema di codice
   

   Identifica che stai utilizzando il sistema di codici LOINC. Uso:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.1

   MedlinePlus Connect accetterà anche:

   mainSearchCriteria.v.cs=2.16.840.1.113883.11.79

2. Codice
   identifica il codice effettivo che stai cercando di cercare:
   mainSearchCriteria.v.c=3187-2

Parametri opzionali

Codice Titolo

Puoi anche identificare il nome del test di laboratorio. Tuttavia, queste informazioni non influiscono sulla risposta. mainSearchCriteria.v.dn=Saggio del fattore IX

Vedere la sezione precedente sui parametri di output per i dettagli sulla lingua e sui formati di output.

Descrizione degli elementi Atom selezionati (o oggetti JSON) in risposta alle richieste di test di laboratorio

Elemento	Descrizione
titolo	Titolo della pagina di test di laboratorio MedlinePlus abbinata
collegamento	URL per la pagina del test di laboratorio MedlinePlus corrispondente
sommario	Frammento dal contenuto della pagina
autore	Attribuzione della fonte per il contenuto del test di laboratorio

Esempi di richieste di test di laboratorio

Per richiedere informazioni per un madrelingua inglese, la tua richiesta potrebbe essere una delle 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 =en

Per richiedere informazioni per un madrelingua spagnolo, la tua richiesta potrebbe essere una delle 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 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.

Maggiori informazioni