MedlinePlus Connect: Servicio web
Contenido
- Descripción general del servicio web
- Parámetros de salida
- Solicitudes de códigos de diagnóstico (problema)
- Parámetros opcionales
- Descripción de los elementos Atom seleccionados (u objetos JSON) en respuesta a las solicitudes de códigos de problemas
- Ejemplos de solicitudes de códigos de problemas
- Servicios y archivos relacionados
- Solicitudes de información sobre medicamentos
- Parámetros opcionales
- Descripción de los elementos Atom seleccionados (u objetos JSON) en respuesta a las solicitudes de medicación
- Ejemplos de solicitudes de códigos de medicamentos
- Solicitudes de información sobre pruebas de laboratorio
- Parámetros opcionales
- Descripción de los elementos Atom seleccionados (u objetos JSON) en respuesta a las solicitudes de prueba de laboratorio
- 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 detallan los detalles técnicos para implementar el servicio Web, que responde a las solicitudes en base a:
Puede vincular y mostrar los datos devueltos por MedlinePlus Connect. No puede copiar páginas de MedlinePlus en su sitio. Si usa datos del servicio web MedlinePlus Connect, indique que la información es de MedlinePlus.gov, pero no use el logotipo de MedlinePlus ni dé a entender que MedlinePlus respalda su producto en particular. Consulte la página de la API de NLM para obtener más información. 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.
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.
Descripción general del servicio web
Los parámetros para las solicitudes de servicios web se ajustan a la Guía de implementación basada en URL de solicitud de conocimiento de recuperación de conocimiento consciente del contexto (botón de información) de HL7. La respuesta basada en REST se ajusta a la Guía de implementación de la arquitectura orientada al servicio (Infobutton) de recuperación de conocimientos sensibles al contexto (Infobutton) de HL7. La salida de la solicitud puede ser XML en formato de fuente Atom, JSON o JSONP.
La estructura de la solicitud indica qué tipo de código está enviando. En todos los casos, la URL base del servicio web es: https://connect.medlineplus.gov/service
MedlinePlus Connect utiliza conexiones HTTPS. No se aceptarán solicitudes HTTP y las implementaciones existentes que utilicen HTTP deben actualizarse a HTTPS.
Parámetros de salida
Estos parámetros son opcionales. Si los omite, la respuesta predeterminada es información en inglés en formato XML.
Idioma
Identifique si desea que la respuesta 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
Formato
Identifique si desea que el formato de respuesta sea XML, JSON o JSONP. XML es el predeterminado.
- Para solicitar JSON, use:
- knowledgeResponseType = aplicación / json
- Para JSONP, use:
- knowledgeResponseType = application / javascript & callback = CallbackFunction donde CallbackFunction es un nombre que le da a la función de devolución de llamada.
- Para una respuesta en XML, use:
- knowledgeResponseType = text / xml o deje el parámetro knowledgeResponseType fuera de la solicitud.
Solicitudes de códigos de diagnóstico (problema)
Para un código de problema, MedlinePlus Connect devolverá enlaces e información de páginas de temas de salud de MedlinePlus, páginas de genética o páginas de otros Institutos NIH.
MedlinePlus Connect devolverá lo siguiente:
Puede que no siempre haya una coincidencia para cada código. En esos casos, MedlinePlus Connect devolverá una respuesta nula.
La URL base del servicio es: https://connect.medlineplus.gov/service
Hay dos parámetros obligatorios para cualquier consulta a este servicio:
- Sistema de codificació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
- Código
Identifique el código real que está intentando buscar:
mainSearchCriteria.v.c = 250,33
Parámetros opcionales
Título del código
También puede identificar el nombre / título del código del problema. Sin embargo, esta información no afecta la respuesta (a diferencia de la aplicación web MedlinePlus Connect, donde se puede usar la información del nombre / título). mainSearchCriteria.v.dn = Diabetes mellitus con otro coma tipo 1 no controlado Consulte la sección anterior sobre Parámetros de salida para obtener detalles sobre el idioma y los formatos de salida.
Descripción de los elementos Atom seleccionados (u objetos JSON) en respuesta a las solicitudes de códigos de problemas
| Elemento | Nodo de clase | Descripción |
|---|---|---|
| título | Título de la página de temas de salud de MedlinePlus o la página de GHR coincidentes | |
| Enlace | URL de la página de temas de salud de MedlinePlus o la página de GHR coincidentes | |
| resumen | El resumen completo del tema de salud. Esto incluye enlaces incrustados a otros temas de salud relevantes y todo el formato, incluidas las viñetas y el espaciado de párrafos. El resumen está en HTML. Para las páginas de GHR, se proporciona la primera sección de la página completa. | |
| resumen | Sinónimos para el tema. Estos se denominan "También llamados" en una página de temas de salud. No todos los temas tienen términos "También llamados". | |
| resumen | Reconocimiento de atribución para el texto de resumen, si la mayor parte del resumen fue de otra agencia federal. No todos los resúmenes tienen atribución. El texto sin atribuir es original de MedlinePlus. | |
| resumen | Enlaces seleccionados asociados al tema. Esto incluye el nombre de la página, la URL y la organización asociada (cuando corresponda). Los enlaces tienen el formato de una lista con viñetas. No todos los temas tienen estos enlaces. El número de enlaces puede oscilar entre cero y docenas. |
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/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% 20incontrolled & informationRecipient.languageCode.c = es
Un paciente con el mismo diagnóstico pero el formato solicitado es JSON y el idioma es inglés: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json
Un paciente diagnosticado con "neumonía por Pseudomonas" utilizando el código SNOMED CT 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Neumonía% 20debido% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = es
Un paciente con el mismo diagnóstico, pero el formato solicitado es JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=C
Servicios y archivos relacionados
Para recibir temas de salud de MedlinePlus en respuesta a solicitudes de texto, en lugar de códigos de problemas, investigue el servicio web de MedlinePlus. Además, si necesita el conjunto completo de temas de salud de MedlinePlus en formato XML, consulte nuestra página de archivos XML.
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 en inglés o español.
Para solicitudes de información de medicamentos en inglés, si no envía un NDC o RXCUI o si no encontramos ninguna coincidencia en función del código, la aplicación utilizará 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 y no utiliza cadenas de texto. Es posible tener una respuesta en inglés pero no en español.
El servicio web MedlinePlus Connect devolverá lo siguiente:
Puede haber varias respuestas a una solicitud de medicamento. Es posible que no siempre haya una coincidencia para cada solicitud. En esos casos, MedlinePlus Connect devolverá una respuesta nula.
Para solicitudes de información sobre medicamentos, la URL base es: https://connect.medlineplus.gov/service
Para enviar una solicitud, incluya estos datos:
- Sistema de codificación
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
- Código
Identifique el código real que está intentando buscar. (Preferido para inglés, obligatorio para español)
mainSearchCriteria.v.c = 637188 - Nombre de la droga
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
Parámetros opcionales
Título del códigoAl 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. mainSearchCriteria.v.dn = Chantix 0,5 mg tableta oral
Consulte la sección anterior sobre Parámetros de salida para obtener detalles sobre el idioma y los formatos de salida.
Descripción de los elementos Atom seleccionados (u objetos JSON) en respuesta a las solicitudes de medicación
| Elemento | Descripción |
|---|---|
| título | Título de la página de medicamentos de MedlinePlus coincidente |
| Enlace | URL de la página de medicamentos de MedlinePlus coincidente |
| autor | Atribución de la fuente para la información sobre medicamentos |
Ejemplos de solicitudes de códigos de medicamentos
Su solicitud de información sobre medicamentos debe verse como una de las siguientes.
Para solicitar información a través de un RXCUI, su solicitud debe tener este aspecto: 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 = es
Para solicitar información de un NDC para un hispanohablante, su solicitud debe verse así: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-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 solicitudes en inglés. Su solicitud podría verse así: 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
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. El servicio puede brindar una respuesta en inglés o español.
El servicio web MedlinePlus Connect devolverá lo siguiente:
Puede que no siempre haya una coincidencia para cada código. En esos casos, MedlinePlus Connect devolverá una respuesta nula.
La URL base del servicio es: https://connect.medlineplus.gov/service
Estos son dos parámetros obligatorios para cualquier consulta de prueba de laboratorio a este servicio:
- Sistema de codificación
- Identifique que está utilizando el sistema de códigos LOINC. Usar:
- 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
- Código
identifique el código real que está intentando buscar:
mainSearchCriteria.v.c = 3187-2
Parámetros opcionales
Título del códigoTambién puede identificar el nombre de la prueba de laboratorio. Sin embargo, esta información no afecta la respuesta. mainSearchCriteria.v.dn = Ensayo de factor IX
Consulte la sección anterior sobre parámetros de salida para obtener detalles sobre el idioma y los formatos de salida.
Descripción de los elementos Atom seleccionados (u objetos JSON) en respuesta a las solicitudes de prueba de laboratorio
| Elemento | Descripción |
|---|---|
| título | Título de la página de prueba de laboratorio de MedlinePlus coincidente |
| Enlace | URL de la página de prueba de laboratorio de MedlinePlus coincidente |
| resumen | Fragmento del contenido de la página |
| autor | Atribución de fuente para el contenido de la prueba de laboratorio |
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/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
Para solicitar información para un hispanohablante, su solicitud puede verse como una de las siguientes: 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 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.
Más información
Fascinantemente
¿Son las semillas de fenogreco buenas para tu cabello?
