MedlinePlus Connect: servei web

Content

• Visió general del servei web
• Paràmetres de sortida
• Sol·licituds de codis de diagnòstic (problema)
• Paràmetres opcionals
• Descripció dels elements d'àtom seleccionats (o objectes JSON) en resposta a sol·licituds de codi de problema
• Exemples de sol·licituds de codis de problemes
• Serveis i fitxers relacionats
• Sol·licituds d'informació sobre drogues
• Paràmetres opcionals
• Descripció dels elements atòmics seleccionats (o objectes JSON) en resposta a sol·licituds de medicaments
• Exemples de sol·licituds de codis de medicaments
• Sol·licituds d'informació sobre proves de laboratori
• Paràmetres opcionals
• Descripció dels elements d'àtom seleccionats (o objectes JSON) en resposta a les sol·licituds de proves de laboratori
• Exemples de sol·licituds de proves de laboratori
• Política d’ús acceptable
• Més informació

MedlinePlus Connect està disponible com a aplicació web o servei web. A continuació es detallen els detalls tècnics per implementar el servei web, que respon a les sol·licituds basades en:

Podeu enllaçar i mostrar les dades retornades per MedlinePlus Connect. No podeu copiar les pàgines de MedlinePlus al vostre lloc. Si utilitzeu dades del servei web de MedlinePlus Connect, indiqueu que la informació prové de MedlinePlus.gov, però no utilitzeu el logotip de MedlinePlus ni impliqueu que MedlinePlus aprovi el vostre producte en particular. Consulteu la pàgina de l'API de NLM per obtenir més informació. Per obtenir més informació sobre com enllaçar amb contingut de MedlinePlus fora d’aquest servei, consulteu les nostres directrius i instruccions sobre l’enllaç.

Si decidiu utilitzar MedlinePlus Connect, inscriviu-vos a la llista de correu electrònic per estar al dia de les novetats i intercanviar idees amb els vostres companys. Indiqueu-nos si implementeu MedlinePlus Connect posant-vos en contacte amb nosaltres.

Visió general del servei web

Els paràmetres de les sol·licituds de servei web s’ajusten a la Guia d’implementació basada en URL de sol·licitud de coneixement de la sol·licitud de coneixement de la HL7 Context-Aware Knowledge Recuperation (Infobutton). La resposta basada en REST s’ajusta a la Guia d’implementació de l’arquitectura orientada al servei (Infobutton) de recuperació del coneixement (contextualització) del context HL7. La sortida de la sol·licitud pot ser XML en el format de feed Atom, JSON o JSONP.

L’estructura de la sol·licitud indica quin tipus de codi envieu. En tots els casos, l’URL base del servei web és: https://connect.medlineplus.gov/service

MedlinePlus Connect utilitza connexions HTTPS. Les sol·licituds HTTP no s’acceptaran i les implementacions existents que utilitzin HTTP s’han d’actualitzar a HTTPS.

Paràmetres de sortida

Aquests paràmetres són opcionals. Si els deixeu de banda, la resposta per defecte és la informació en anglès en format XML.

Llenguatge
Identifiqueu si voleu que la resposta sigui en anglès o espanyol. MedlinePlus Connect assumirà que l'anglès és l'idioma si no s'especifica.

Si voleu que la resposta a la cerca del codi del problema sigui en castellà, utilitzeu: informationRecipient.languageCode.c = es
(= sp també s'accepta)

Per especificar anglès, utilitzeu el següent: informationRecipient.languageCode.c = ca

Format
Identifiqueu si voleu que el format de resposta sigui XML, JSON o JSONP. XML és el valor per defecte.

Per sol·licitar JSON, utilitzeu:

knowledgeResponseType = application / json

Per a JSONP, utilitzeu:

knowledgeResponseType = application / javascript & callback = CallbackFunction on CallbackFunction és un nom que assigneu a la funció de devolució de trucada.

Per obtenir una resposta en XML, utilitzeu:

knowledgeResponseType = text / xml o deixeu el paràmetre knowledgeResponseType fora de la sol·licitud.

Sol·licituds de codis de diagnòstic (problema)

Per a un codi de problema, MedlinePlus Connect retornarà enllaços i informació de pàgines de temes de salut de MedlinePlus, pàgines de genètica o pàgines d'altres instituts NIH.

MedlinePlus Connect retornarà el següent:

És possible que no sempre hi hagi cap coincidència per a cada codi. En aquests casos, MedlinePlus Connect retornarà una resposta nul·la.

L'URL base del servei és: https://connect.medlineplus.gov/service

Hi ha dos paràmetres obligatoris per a qualsevol consulta d’aquest servei:

1. Sistema de codis
   Identifiqueu el sistema de codi de problemes que utilitzarà.

   Per a ús ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Per a ús ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Per a l'ús de SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Codi
   Identifiqueu el codi real que voleu cercar:
   mainSearchCriteria.v.c = 250,33

Paràmetres opcionals

Títol del codi
També podeu identificar el nom / títol del codi del problema. Tanmateix, aquesta informació no afecta la resposta (a diferència de l'aplicació web MedlinePlus Connect on es pot utilitzar la informació del nom / títol). mainSearchCriteria.v.dn = Diabetis mellitus amb altra coma de tipus 1 sense control Consulteu la secció anterior sobre Paràmetres de sortida per obtenir detalls sobre el llenguatge i els formats de sortida.

Descripció dels elements d'àtom seleccionats (o objectes JSON) en resposta a sol·licituds de codi de problema

Element	Node de classe	Descripció
títol		Títol de la pàgina de tema de salut MedlinePlus o pàgina GHR coincidents
enllaç		URL de la pàgina de tema de salut MedlinePlus o de la pàgina GHR coincidents
resum		El resum complet del tema de salut. Això inclou enllaços incrustats a altres temes relatius a la salut i tot el format, incloses les vinyetes i l’espai entre paràgrafs. El resum està en HTML. Per a les pàgines GHR, es proporciona la primera secció de la pàgina completa.
resum		Sinònims del tema. S'anomena "També s'anomena" a la pàgina d'un tema de salut. No tots els temes tenen termes "També anomenats".
resum		Reconeixement d’atribució del text resum, si la majoria del resum prové d’una altra agència federal. No tots els resums tenen atribució. El text sense atribuir és original de MedlinePlus.
resum		Enllaços seleccionats associats al tema. Inclou el nom de la pàgina, l'URL i l'organització associada (si escau). Els enllaços es formaten en una llista amb vinyetes. No tots els temes tenen aquests enllaços. El nombre d'enllaços pot variar de zero a dotzenes.

Exemples de sol·licituds de codis de problemes

Una sol·licitud completa de Diabetis Mellitus amb un altre coma tipus 1 no controlat, codi ICD-9 250.33, per a un pacient de parla espanyola tindria la següent adreça URL: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabetis% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20uncontrolled & informationRecipient.languageCode.c = es

Un pacient amb el mateix diagnòstic però el format sol·licitat és JSON i l’idioma és l’anglès: 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 amb "Pneumònia per Pseudomonas" mitjançant el codi SNOMED CT 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v Pneumonia% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = ca

Un pacient amb el mateix diagnòstic però el format sol·licitat és 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

Serveis i fitxers relacionats

Per rebre temes de salut de MedlinePlus en resposta a sol·licituds de text, a diferència dels codis de problemes, investigueu el servei web de MedlinePlus. A més, si necessiteu el conjunt complet de temes de salut de MedlinePlus en format XML, consulteu la nostra pàgina de fitxers XML.

Sol·licituds d'informació sobre drogues

MedlinePlus Connect proporciona les millors coincidències d’informació sobre medicaments en rebre un RXCUI. També proporciona bons resultats en rebre un codi NDC. MedlinePlus Connect pot proporcionar respostes en anglès o espanyol.

Per a sol·licituds d'informació sobre medicaments en anglès, si no envieu cap NDC o RXCUI o si no trobem cap coincidència basada en el codi, l'aplicació utilitzarà la cadena de text que envieu per mostrar la millor concordança d'informació sobre medicaments. Per a sol·licituds d'informació sobre medicaments espanyols, MedlinePlus Connect només respon a NDC o RXCUIs i no utilitza cadenes de text. És possible tenir una resposta en anglès, però cap resposta en espanyol.

El servei web MedlinePlus Connect retornarà el següent:

Hi pot haver diverses respostes a una sol·licitud de medicació. És possible que no sempre hi hagi cap coincidència per a cada sol·licitud. En aquests casos, MedlinePlus Connect retornarà una resposta nul·la.

Per a sol·licituds d'informació sobre medicaments, l'URL base és: https://connect.medlineplus.gov/service

Per enviar una sol·licitud, incloeu aquestes dades:

1. Sistema de codis
   Identifiqueu el tipus de codi de medicació que envieu. (Obligatori per a anglès i castellà)
   

   Per utilitzar RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Per a ús NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect també pot acceptar una cadena de text per a sol·licituds d'informació sobre medicaments en anglès, però haureu d'indicar que esteu buscant informació sobre medicaments mitjançant la inclusió d'un dels dos sistemes de codis enumerats anteriorment.
2. Codi
   Identifiqueu el codi real que voleu cercar. (Preferit per a anglès, obligatori per a espanyol)
   mainSearchCriteria.v.c = 637188
3. Nom del medicament
   Identifiqueu el nom del medicament amb una cadena de text. (Opcional per a l'anglès, no s'utilitza per al castellà)
   mainSearchCriteria.v.dn = Tauleta oral Chantix 0,5 MG

Com a mínim, haureu d’identificar el sistema de codis i el codi, o el sistema de codis i el nom del medicament. Envieu els tres per obtenir els millors resultats per a sol·licituds d’anglès. Envieu el sistema de codis i el codi per a sol·licituds espanyoles.

Paràmetres opcionals

Títol del codi

Quan envieu una sol·licitud d'informació en anglès, podeu incloure el paràmetre opcional del nom del medicament. Això es detalla a la secció anterior. mainSearchCriteria.v.dn = Tauleta oral Chantix 0,5 MG

Consulteu la secció anterior sobre Paràmetres de sortida per obtenir detalls sobre l’idioma i els formats de sortida.

Descripció dels elements atòmics seleccionats (o objectes JSON) en resposta a sol·licituds de medicaments

Element	Descripció
títol	Títol de la pàgina de medicaments de MedlinePlus coincidents
enllaç	URL de la pàgina de medicaments de MedlinePlus coincident
autor	Atribució de la font d'informació sobre medicaments

Exemples de sol·licituds de codis de medicaments

La vostra sol·licitud d'informació sobre medicaments hauria de ser una de les següents.

Per sol·licitar informació mitjançant un RXCUI, la vostra sol·licitud hauria de ser la següent: 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 = ca

Per sol·licitar informació d'un NDC per a un espanyol parlant, la vostra sol·licitud hauria de ser la següent: 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 enviar una cadena de text sense cap codi de medicació, heu d’identificar la vostra consulta com una sol·licitud de tipus NDC perquè MedlinePlus Connect sàpiga que esteu buscant informació sobre medicaments. Això funcionarà només per a sol·licituds en anglès. La vostra sol·licitud podria tenir aquest aspecte: 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 = ca

Sol·licituds d'informació sobre proves de laboratori

MedlinePlus Connect proporciona coincidències amb la informació de proves de laboratori quan rep una sol·licitud LOINC. El servei pot proporcionar una resposta en anglès o espanyol.

El servei web MedlinePlus Connect retornarà el següent:

És possible que no sempre hi hagi cap coincidència per a cada codi. En aquests casos, MedlinePlus Connect retornarà una resposta nul·la.

L'URL base del servei és: https://connect.medlineplus.gov/service

Aquests són dos paràmetres obligatoris per a qualsevol consulta de prova de laboratori d’aquest servei:

1. Sistema de codis
   

   Identifiqueu que utilitzeu el sistema de codis LOINC. Ús:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect també acceptarà:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Codi
   identifiqueu el codi real que voleu cercar:
   mainSearchCriteria.v.c = 3187-2

Paràmetres opcionals

Títol del codi

També podeu identificar el nom de la prova de laboratori. Tanmateix, aquesta informació no afecta la resposta. mainSearchCriteria.v.dn = Assaig del factor IX

Consulteu la secció anterior sobre Paràmetres de sortida per obtenir detalls sobre l’idioma i els formats de sortida.

Descripció dels elements d'àtom seleccionats (o objectes JSON) en resposta a les sol·licituds de proves de laboratori

Element	Descripció
títol	Títol de la pàgina de prova de laboratori de MedlinePlus coincident
enllaç	URL de la pàgina de prova de laboratori de MedlinePlus coincident
resum	Fragment del contingut de la pàgina
autor	Atribució d'origen per al contingut de les proves de laboratori

Exemples de sol·licituds de proves de laboratori

Per sol·licitar informació per a un anglès, la vostra sol·licitud pot semblar una de les següents: 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 = ca

Per sol·licitar informació per a un castellanoparlant, la vostra sol·licitud pot semblar una de les següents: 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

Política d’ús acceptable

Per evitar una sobrecàrrega dels servidors MedlinePlus, NLM requereix que els usuaris de MedlinePlus Connect no enviïn més de 100 sol·licituds per minut per adreça IP. Les sol·licituds que superin aquest límit no seran ateses i el servei no es restaurarà durant 300 segons o fins que la taxa de sol·licitud caigui per sota del límit, el que passi més tard. Per limitar el nombre de sol·licituds que envieu a Connect, NLM recomana obtenir resultats de memòria cau durant un període de 12 a 24 hores.

Aquesta política està establerta per garantir que el servei estigui disponible i accessible per a tots els usuaris. Si teniu un cas d’ús específic que requereixi que envieu un gran nombre de sol·licituds a MedlinePlus Connect i, per tant, supereu el límit de taxa de sol·licituds descrit en aquesta política, poseu-vos en contacte amb nosaltres. El personal de NLM avaluarà la vostra sol·licitud i determinarà si es pot concedir una excepció. Consulteu també la documentació dels fitxers XML de MedlinePlus. Aquests fitxers XML contenen registres temàtics complets i poden servir com a mètode alternatiu d’accés a les dades de MedlinePlus.

Més informació