MedlinePlus Connect: Aplicación web
Contenido
- Descripción general de la aplicación web
- Solicitudes de códigos de diagnóstico (problema)
- Parámetros opcionales
- Ejemplos de solicitudes de códigos de problemas
- Solicitudes de información sobre medicamentos
- Parámetros opcionales
- Ejemplos de solicitudes de códigos de medicamentos
- Solicitudes de información sobre pruebas de laboratorio
- Parámetros opcionales
- Ejemplos de solicitudes de pruebas de laboratorio
- Política de uso aceptable
- Más información
MedlinePlus Connect está disponible como una aplicación web o un servicio web. A continuación se muestran los detalles técnicos para implementar la aplicación web, que responde a las solicitudes en base a:
Si decide utilizar MedlinePlus Connect, regístrese en la lista de correo electrónico para mantenerse al día con los desarrollos e intercambiar ideas con sus colegas. Comuníquese con nosotros si implementa MedlinePlus Connect. Puede vincular y mostrar los datos proporcionados por MedlinePlus Connect. Para obtener más información sobre cómo vincular el contenido de MedlinePlus fuera de este servicio, consulte nuestras pautas e instrucciones sobre la vinculación.
Descripción general de la aplicación web
La API para la aplicación web se ajusta a la especificación de implementación basada en URL de solicitud de conocimiento de recuperación de conocimiento consciente del contexto (Infobutton) de HL7. La estructura de la solicitud indica qué tipo de código está enviando. En todos los casos, la URL base de la aplicación web es: https://connect.medlineplus.gov/application
MedlinePlus Connect utiliza conexiones HTTPS. No se aceptarán solicitudes HTTP y las implementaciones existentes que utilicen HTTP deben actualizarse a HTTPS.
Solicitudes de códigos de diagnóstico (problema)
MedlinePlus Connect hace coincidir los códigos ICD-10-CM, ICD-9-CM o SNOMED CT con páginas de temas de salud relacionados con MedlinePlus, páginas de genética o páginas de otros institutos de los NIH. Por ejemplo, a un paciente diagnosticado con el código ICD-9-CM 493.12, Asma extrínseca con exacerbación, se le podría presentar un enlace en una historia clínica electrónica (HCE) que lo lleve a la página de MedlinePlus Asma.
Para solicitudes por problema, la URL base de la aplicación es: https://connect.medlineplus.gov/applicationEste enlace muestra una página con un cuadro de búsqueda vacío. Hay dos parámetros obligatorios para cualquier consulta a esta aplicación:
- Identifique el sistema de códigos de problemas que utilizará.
- Para uso de ICD-10-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- Para uso de ICD-9-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- Para uso de SNOMED CT:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Identifique el código real que está intentando buscar:
mainSearchCriteria.v.c = 250,33
Parámetros opcionales
Identifique el nombre / título del código del problema. No enviar ningún código resultará en una consulta al motor de búsqueda de MedlinePlus. Si especifica un código y el nombre / título del código, pero MedlinePlus Connect no tiene resultados, la página de respuesta mostrará un cuadro de búsqueda de MedlinePlus rellenado previamente con el nombre / título. mainSearchCriteria.v.dn = Diabetes mellitus con otro coma tipo 1 no controlado
Identifique si desea que la solicitud esté en inglés o en español. MedlinePlus Connect asumirá que el inglés es el idioma si no se especifica.
Si desea que la respuesta a la búsqueda del código del problema esté en español, use: informationRecipient.languageCode.c = es
(= sp también aceptado)
Para especificar el inglés, utilice lo siguiente: informationRecipient.languageCode.c = en
Ejemplos de solicitudes de códigos de problemas
Una solicitud completa para Diabetes Mellitus con otro coma tipo 1 no controlado, código ICD-9 250.33, para un paciente de habla hispana tendría la siguiente dirección 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% 20incontrolled & informationRecipient.languageCode.c = es
Un paciente diagnosticado con "neumonía por Pseudomonas" utilizando el código SNOMED CT 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchnCriteria.v.d.d. Neumonía% 20debido% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = es
Una consulta de formato libre, sin sistema de código o código de problema, utilizará el motor de búsqueda de MedlinePlus (solo en inglés): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
Solicitudes de información sobre medicamentos
MedlinePlus Connect proporciona las mejores coincidencias de información sobre medicamentos al recibir una RXCUI. También proporciona buenos resultados al recibir un código NDC. MedlinePlus Connect puede proporcionar respuestas a solicitudes de códigos de medicamentos en inglés o español y devolverá un enlace a una página de resultados con las mejores coincidencias de la información de medicamentos de MedlinePlus.
Para solicitudes de información de medicamentos en inglés, si no envía un código NDC o RXCUI o si no encontramos ninguna coincidencia en función del código, usaremos la cadena de texto que envíe para mostrar la mejor coincidencia de información de medicamentos. Para solicitudes de información sobre medicamentos en español, MedlinePlus Connect responde solo a NDC o RXCUI; no utiliza cadenas de texto. Es posible tener una respuesta en inglés pero no en español.
Puede haber varias respuestas a una solicitud de medicamento. Es posible que no siempre haya una coincidencia para cada solicitud. Si MedlinePlus Connect encuentra una respuesta nula para una solicitud de medicamento, el programa muestra un cuadro de búsqueda para el sitio de MedlinePlus. Un usuario puede escribir el nombre de un medicamento y puede obtener una buena respuesta.
Para solicitudes de información sobre medicamentos, la URL base es: https://connect.medlineplus.gov/application
Las solicitudes de información sobre medicamentos en inglés y español tienen requisitos diferentes. Para enviar una solicitud, incluya estos datos:
- Identifique el tipo de código de medicamento que está enviando. (Requerido para inglés y español)
- Para uso de RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Para uso de NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Identifique el código real que está intentando buscar. (Preferido para inglés, obligatorio para español)
mainSearchCriteria.v.c = 637188 - Identifique el nombre del medicamento con una cadena de texto. (Opcional para inglés, no utilizado para español)
mainSearchCriteria.v.dn = Chantix 0,5 mg tableta oral
Para solicitudes en inglés, debe identificar como mínimo el sistema de códigos y el código, o el sistema de códigos y el nombre del medicamento. Envíe los tres para obtener mejores resultados para las solicitudes en inglés. Para solicitudes en español, debe identificar el sistema de código y el código.
Parámetros opcionales
Al enviar una solicitud de información en inglés, puede incluir el parámetro opcional del nombre del medicamento. Esto se detalla en la sección anterior. Este parámetro no se utiliza para solicitudes en español.
Identifique si desea que la solicitud esté en inglés o en español. MedlinePlus Connect asumirá que el inglés es el idioma si no se especifica.
Si desea que la respuesta a la búsqueda del código del medicamento esté en español, use: informationRecipient.languageCode.c = es (= sp también aceptado)
Para especificar el inglés, utilice lo siguiente: informationRecipient.languageCode.c = en
Ejemplos de solicitudes de códigos de medicamentos
Su solicitud de información sobre medicamentos debe verse como uno de los siguientes.
Para solicitar información a través de un RXCUI, su solicitud debe tener este aspecto: 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 = es
Para solicitar información de un NDC para un hispanohablante, su solicitud debe tener este aspecto: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.languageCode.c = es
Para enviar una cadena de texto sin un código de medicamento, debe identificar su consulta como una solicitud de tipo NDC para que MedlinePlus Connect sepa que está buscando información sobre medicamentos. Esto funcionará solo para inglés. Su solicitud podría verse así: 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
Solicitudes de información sobre pruebas de laboratorio
MedlinePlus Connect proporciona coincidencias con la información de las pruebas de laboratorio cuando recibe una solicitud LOINC. MedlinePlus Connect puede proporcionar respuestas a las solicitudes de pruebas de laboratorio en inglés o español y devolverá un enlace a una página de resultados con las mejores coincidencias de la información de las pruebas de laboratorio de MedlinePlus.
Para solicitudes de información sobre pruebas de laboratorio, la URL base es: https://connect.medlineplus.gov/application
Estos son dos parámetros obligatorios para cualquier consulta de prueba de laboratorio para esta aplicación:
- Identifique que está utilizando el sistema de códigos LOINC.
- Para uso LOINC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect también aceptará:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Identifique el código real que está intentando buscar.
mainSearchCriteria.v.c = 3187-2
Parámetros opcionales
Identifique el nombre / título de la prueba de laboratorio. Sin embargo, esta información no afecta la respuesta. mainSearchCriteria.v.dn = Ensayo de factor IX
Identifique si desea que la solicitud esté en inglés o en español. MedlinePlus Connect asumirá que el inglés es el idioma si no se especifica.
Si desea que la respuesta a la búsqueda del código del problema esté en español, use: informationRecipient.languageCode.c = es (= sp también aceptado)
Para especificar el inglés, utilice lo siguiente: informationRecipient.languageCode.c = en
Una consulta de forma libre, sin sistema de código o código de laboratorio, utilizará el motor de búsqueda de MedlinePlus. Este enfoque es más eficaz con los diagnósticos (consulte la información del código del problema anterior) en lugar de las cadenas de texto de prueba de laboratorio. Su solicitud de información de la prueba de laboratorio debe verse como una de las siguientes.
Ejemplos de solicitudes de pruebas de laboratorio
Para solicitar información para un hablante de inglés, su solicitud puede verse como una de las siguientes: 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
Para solicitar información para un hispanohablante, su solicitud puede verse como una de las siguientes: 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 de uso aceptable
Para evitar sobrecargar los servidores de MedlinePlus, NLM requiere que los usuarios de MedlinePlus Connect no envíen más de 100 solicitudes por minuto por dirección IP. Las solicitudes que superen este límite no serán atendidas y el servicio no se restablecerá durante 300 segundos o hasta que la tasa de solicitudes caiga por debajo del límite, lo que ocurra más tarde. Para limitar la cantidad de solicitudes que envía a Connect, NLM recomienda almacenar los resultados en caché durante un período de 12 a 24 horas.
Esta política está implementada para garantizar que el servicio permanezca disponible y accesible para todos los usuarios. Si tiene un caso de uso específico que requiere que envíe una gran cantidad de solicitudes a MedlinePlus Connect y, por lo tanto, exceda el límite de tasa de solicitud descrito en esta política, contáctenos. El personal de NLM evaluará su solicitud y determinará si se puede otorgar una excepción. Consulte también la documentación de los archivos XML de MedlinePlus. Estos archivos XML contienen registros completos de temas de salud y pueden servir como un método alternativo para acceder a los datos de MedlinePlus.