MedlinePlus Connect: aplicació web

Content

• Descripció general de l'aplicació web
• Sol·licituds de codis de diagnòstic (problema)
• Paràmetres opcionals
• Exemples de sol·licituds de codis de problemes
• Sol·licituds d'informació sobre drogues
• Paràmetres opcionals
• Exemples de sol·licituds de codis de medicaments
• Sol·licituds d'informació sobre proves de laboratori
• Paràmetres opcionals
• 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 l’aplicació web, que respon a les sol·licituds basades en:

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. Podeu enllaçar i mostrar les dades proporcionades per MedlinePlus Connect. 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ç.

Descripció general de l'aplicació web

L’API de l’aplicació web s’ajusta a l’especificació d’implementació basada en l’URL de la sol·licitud de coneixement del coneixement de recuperació de coneixement (infobutó) HL7. L’estructura de la sol·licitud indica quin tipus de codi envieu. En tots els casos, l’URL base de l’aplicació web és: https://connect.medlineplus.gov/application

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.

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

MedlinePlus Connect fa coincidir codis ICD-10-CM, ICD-9-CM o SNOMED CT amb pàgines relacionades amb temes de salut de MedlinePlus, pàgines de genètica o pàgines d'altres instituts NIH. Per exemple, a un pacient amb diagnòstic del codi ICD-9-CM 493.12, asma extrínseca amb exacerbació, se li pot presentar un enllaç en un registre sanitari electrònic (EHR) que condueix a la pàgina de MedlinePlus Asthma.

Aquest enllaç mostra una pàgina amb un quadre de cerca buit. Hi ha dos paràmetres obligatoris per a qualsevol consulta d'aquesta aplicació:

1. 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. Identifiqueu el codi real que voleu cercar:
   mainSearchCriteria.v.c = 250,33

Paràmetres opcionals

Identifiqueu el nom / títol del codi del problema. Si no envieu cap codi, es produirà una consulta al motor de cerca MedlinePlus. Si especifiqueu un codi i el nom / títol del codi, però MedlinePlus Connect no té resultats, la pàgina de resposta mostrarà un quadre de cerca de MedlinePlus pre-poblat amb el nom / títol. mainSearchCriteria.v.dn = Diabetis mellitus amb un altre coma de tipus 1 sense control

Identifiqueu si voleu que la sol·licitud 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

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/application?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 diagnosticat amb "Pneumònia per Pseudomonas" mitjançant el codi SNOMED CT 41381004: https://connect.medlineplus.gov/application?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 = ca

Una consulta de forma lliure, sense sistema de codi ni codi de problema, utilitzarà el motor de cerca MedlinePlus (només en anglès): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

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 a les sol·licituds de codi de medicació en anglès o espanyol i us retornarà un enllaç a una pàgina de resultats amb els millors resultats de la informació sobre medicaments de MedlinePlus.

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

Pot haver-hi respostes múltiples a una sol·licitud de medicació. És possible que no sempre hi hagi cap coincidència per a cada sol·licitud. Si MedlinePlus Connect troba una resposta nul·la per a una sol·licitud de medicaments, el programa mostra un quadre de cerca del lloc de MedlinePlus. Un usuari pot escriure un nom de medicament i pot obtenir una bona resposta.

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

Les sol·licituds d'informació sobre medicaments en anglès i espanyol tenen requisits diferents. Per enviar una sol·licitud, incloeu aquestes dades:

1. 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

2. Identifiqueu el codi real que voleu cercar. (Preferit per a anglès, obligatori per a espanyol)
   mainSearchCriteria.v.c = 637188
3. 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

Per a sol·licituds d’anglès, heu d’identificar com a mínim 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. Per a sol·licituds espanyoles, heu d’identificar el sistema de codi i el codi.

Paràmetres opcionals

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. Aquest paràmetre no s'utilitza per a sol·licituds espanyoles.

Identifiqueu si voleu que la sol·licitud 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 de codi de medicació sigui en castellà, utilitzeu: informationRecipient.languageCode.c = es (= també s’accepta sp)

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

Exemples de sol·licituds de codis de medicaments

La vostra sol·licitud d'informació sobre medicaments hauria de ser semblant a 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/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 = 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/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-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 anglès. La vostra sol·licitud podria tenir aquest aspecte: 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 = 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. MedlinePlus Connect pot proporcionar respostes a les sol·licituds de proves de laboratori en anglès o espanyol i us retornarà un enllaç a una pàgina de resultats amb els millors resultats de la informació de proves de laboratori de MedlinePlus.

Per a sol·licituds d'informació de proves de laboratori, l'URL base és: https://connect.medlineplus.gov/application

Aquests són dos paràmetres obligatoris per a qualsevol consulta de prova de laboratori a aquesta aplicació:

1. Identifiqueu que utilitzeu el sistema de codis LOINC.
   

   Per a ús LOINC:

   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. Identifiqueu el codi real que voleu cercar.
   mainSearchCriteria.v.c = 3187-2

Paràmetres opcionals

Identifiqueu el nom / títol de la prova de laboratori. Tanmateix, aquesta informació no afecta la resposta. mainSearchCriteria.v.dn = Assaig del factor IX

Identifiqueu si voleu que la sol·licitud 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 (= també s’accepta sp)

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

Una consulta de forma lliure, sense sistema de codi ni codi de laboratori, utilitzarà el motor de cerca MedlinePlus. Aquest enfocament és més eficaç amb els diagnòstics (vegeu la informació del codi del problema anterior) en lloc de les cadenes de text de la prova de laboratori. La vostra sol·licitud d'informació de proves de laboratori hauria de ser semblant a una de les següents.

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/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 = ca

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

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ó