MedlinePlus Connect: servizo web

Contido

• Vista xeral do servizo web
• Parámetros de saída
• Solicitudes de códigos de diagnóstico (problema)
• Parámetros opcionais
• Descrición dos elementos do átomo seleccionados (ou obxectos JSON) en resposta ás solicitudes de código de problema
• Exemplos de solicitudes de códigos de problemas
• Servizos e ficheiros relacionados
• Solicitudes de información sobre drogas
• Parámetros opcionais
• Descrición dos elementos átomos seleccionados (ou obxectos JSON) en resposta ás solicitudes de medicamentos
• Exemplos de solicitudes de códigos de drogas
• Solicitudes de información sobre probas de laboratorio
• Parámetros opcionais
• Descrición dos elementos do átomo seleccionados (ou obxectos JSON) en resposta ás solicitudes de proba de laboratorio
• Exemplos de solicitudes de probas de laboratorio
• Política de uso aceptable
• Máis información

MedlinePlus Connect está dispoñible como aplicación web ou servizo web. Abaixo amósanse os detalles técnicos para implementar o servizo web, que responde ás solicitudes baseadas en:

Benvido pode ligar e amosar os datos devoltos por MedlinePlus Connect. Non podes copiar as páxinas de MedlinePlus no teu sitio. Se usa datos do servizo web MedlinePlus Connect, indique que a información é de MedlinePlus.gov pero non use o logotipo de MedlinePlus ou implica que MedlinePlus apoia o seu produto en particular. Consulte a páxina da API de NLM para obter máis orientacións. Para obter máis información sobre como ligar ao contido de MedlinePlus fóra deste servizo, consulte as nosas directrices e instrucións sobre a ligazón.

Se decides usar MedlinePlus Connect, rexístrate na lista de correo electrónico para estar ao día dos desenvolvementos e intercambiar ideas cos teus colegas. Indícanos se implementas MedlinePlus Connect contactando connosco.

Vista xeral do servizo web

Os parámetros para as solicitudes de servizos web axústanse á Guía de implementación baseada na URL de solicitude de coñecemento de recuperación de coñecemento (infobutón) HL7 Context-Aware Knowledge Recuperation (Infobutton). A resposta baseada en REST axústase á Guía de implementación da arquitectura orientada ao servizo (Infobutón) de recuperación de coñecemento con coñecemento do contexto HL7. A saída da solicitude pode ser XML no formato de alimentación Atom, JSON ou JSONP.

A estrutura da solicitude indica que tipo de código está a enviar. En todos os casos, o URL base do servizo web é: https://connect.medlineplus.gov/service

MedlinePlus Connect usa conexións HTTPS. Non se aceptarán solicitudes HTTP e as implementacións existentes que usen HTTP deberían actualizarse a HTTPS.

Parámetros de saída

Estes parámetros son opcionais. Se os deixas fóra, a resposta predeterminada é a información en inglés en formato XML.

Lingua
Identifique se desexa que a resposta sexa en inglés ou español. MedlinePlus Connect asumirá que o inglés é o idioma se non se especifica.

Se desexa que a resposta á busca de código do problema estea en español, use: informationRecipient.languageCode.c = es
(= sp tamén aceptado)

Para especificar inglés, use o seguinte: informationRecipient.languageCode.c = gl

Formato
Identifique se desexa que o formato de resposta sexa XML, JSON ou JSONP. XML é o predeterminado.

Para solicitar JSON, use:

knowledgeResponseType = aplicación / json

Para JSONP, use:

knowledgeResponseType = application / javascript & callback = CallbackFunction onde CallbackFunction é un nome que lle dá á función de devolución de chamada.

Para obter unha resposta en XML, use:

knowledgeResponseType = text / xml ou deixa o parámetro knowledgeResponseType fóra da solicitude.

Solicitudes de códigos de diagnóstico (problema)

Para un código de problema, MedlinePlus Connect devolverá ligazóns e información de páxinas de temas de saúde de MedlinePlus, páxinas de xenética ou páxinas doutros institutos NIH.

MedlinePlus Connect devolverá o seguinte:

Pode que non sempre haxa coincidencia para cada código. Neses casos, MedlinePlus Connect devolverá unha resposta nula.

A URL base do servizo é: https://connect.medlineplus.gov/service

Hai dous parámetros necesarios para calquera consulta deste servizo:

1. Sistema de código
   Identifique o sistema de código de problemas que empregará.

   Para uso de ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Para uso ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Para uso SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Código
   Identifique o código real que intenta buscar:
   mainSearchCriteria.v.c = 250,33

Parámetros opcionais

Título do código
Tamén pode identificar o nome / título do código do problema. Non obstante, esta información non afecta á resposta (a diferenza da aplicación web MedlinePlus Connect onde se pode empregar a información do nome / título). mainSearchCriteria.v.dn = Diabetes mellitus con outro coma de tipo 1 sen control Ver a sección anterior sobre Parámetros de saída para máis detalles sobre o idioma e os formatos de saída.

Descrición dos elementos do átomo seleccionados (ou obxectos JSON) en resposta ás solicitudes de código de problema

Elemento	Nodo de clase	Descrición
título		Título da páxina de tema de saúde MedlinePlus ou páxina GHR coincidentes
ligazón		URL da páxina de tema de saúde de MedlinePlus ou páxina GHR coincidentes
resumo		O resumo completo do tema da saúde. Isto inclúe ligazóns incrustadas a outros temas relevantes de saúde e todo o formato, incluíndo viñetas e espaciado entre parágrafos. O resumo está en HTML. Para as páxinas GHR, inclúese a primeira sección da páxina completa.
resumo		Sinónimos do tema. Denomínanse "Tamén chamados" nunha páxina de temas de saúde. Non todos os temas teñen termos "Tamén chamados".
resumo		Recoñecemento da atribución do texto resumido, se a maioría do resumo foi doutra axencia federal. Non todos os resumos teñen unha atribución. O texto sen atribuír é orixinal para MedlinePlus.
resumo		Ligazóns seleccionadas asociadas ao tema. Isto inclúe o nome da páxina, o URL e a organización asociada (cando corresponda). As ligazóns formátanse nunha lista con viñetas. Non todos os temas teñen estas ligazóns. O número de ligazóns pode ir de cero a decenas.

Exemplos de solicitudes de códigos de problemas

Unha solicitude completa de diabetes mellitus con outro coma tipo 1 sen control, código ICD-9 250.33, para un paciente de fala hispana tería o seguinte enderezo 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% 20uncontrolled & informationRecipient.languageCode.c = es

Un paciente co mesmo diagnóstico pero o formato solicitado é JSON e o idioma é o 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 de "Neumonía por Pseudomonas" mediante o código SNOMED CT 41381004: https://connect.medlineplus.gov/service?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 = gl

Un paciente co mesmo diagnóstico pero o formato solicitado é 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

Servizos e ficheiros relacionados

Para recibir temas de saúde de MedlinePlus en resposta a solicitudes de texto, en lugar de códigos de problemas, investigue o servizo web de MedlinePlus. Ademais, se precisa o conxunto completo de temas de saúde de MedlinePlus en formato XML, consulte a nosa páxina de ficheiros XML.

Solicitudes de información sobre drogas

MedlinePlus Connect ofrece as mellores coincidencias de información sobre medicamentos ao recibir un RXCUI. Tamén proporciona bos resultados ao recibir un código NDC. MedlinePlus Connect pode proporcionar respostas en inglés ou español.

Para solicitudes de información sobre medicamentos en inglés, se non envía NDC ou RXCUI ou se non atopamos ningunha coincidencia baseada no código, a aplicación empregará a cadea de texto que envíe para mostrar a mellor coincidencia de información sobre medicamentos. Para solicitudes de información sobre medicamentos en español, MedlinePlus Connect responde só a NDC ou RXCUIs e non usa cadeas de texto. É posible ter unha resposta en inglés pero ningunha resposta en español.

O servizo web MedlinePlus Connect devolverá o seguinte:

Pode haber varias respostas a unha solicitude de medicamento. Pode que non sempre haxa coincidencia para cada solicitude. Neses casos, MedlinePlus Connect devolverá unha resposta nula.

Para solicitudes de información sobre drogas, o URL base é: https://connect.medlineplus.gov/service

Para enviar unha solicitude, inclúa estes datos:

1. Sistema de código
   Identifique o tipo de código de medicación que está a enviar. (Obrigatorio para inglés e español)
   

   Para uso RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Para uso NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect tamén pode aceptar unha cadea de texto para solicitudes de información sobre medicamentos en inglés, pero debe indicar que está a buscar información sobre medicamentos incluíndo un dos dous sistemas de código enumerados anteriormente.
2. Código
   Identifique o código real que intenta buscar. (Preferido para inglés, obrigatorio para español)
   mainSearchCriteria.v.c = 637188
3. Nome da droga
   Identifique o nome da droga cunha cadea de texto. (Opcional para inglés, non usado para español)
   mainSearchCriteria.v.dn = Tableta oral Chantix 0,5 MG

Como mínimo, debe identificar o sistema de código e o código, ou o sistema de código e o nome da droga. Envíe os tres para obter os mellores resultados para solicitudes de inglés. Envía o sistema de código e o código para solicitudes en español.

Parámetros opcionais

Título do código

Ao enviar unha solicitude de información en inglés, pode incluír o parámetro opcional do nome do medicamento. Isto detállase na sección anterior. mainSearchCriteria.v.dn = Tableta oral Chantix 0,5 MG

Vexa a sección anterior sobre Parámetros de saída para máis detalles sobre o idioma e os formatos de saída.

Descrición dos elementos átomos seleccionados (ou obxectos JSON) en resposta ás solicitudes de medicamentos

Elemento	Descrición
título	Título da páxina de medicamentos de MedlinePlus coincidentes
ligazón	URL da páxina de medicamentos de MedlinePlus coincidente
autor	Atribución da fonte da información sobre medicamentos

Exemplos de solicitudes de códigos de drogas

A solicitude de información sobre medicamentos debería parecer unha das seguintes.

Para solicitar información mediante un RXCUI, a súa solicitude debería ter o seguinte 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 = gl

Para solicitar información por parte dun NDC para un falante de español, a súa solicitude debería ser a seguinte: 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 unha cadea de texto sen un código de medicación, debes identificar a túa consulta como unha solicitude de tipo NDC para que MedlinePlus Connect saiba que estás a buscar información sobre medicamentos. Isto funcionará só para solicitudes en inglés. A túa solicitude podería ter o seguinte aspecto: 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 = gl

Solicitudes de información sobre probas de laboratorio

MedlinePlus Connect proporciona coincidencias coa información das probas de laboratorio cando recibe unha solicitude LOINC. O servizo pode proporcionar unha resposta en inglés ou español.

O servizo web MedlinePlus Connect devolverá o seguinte:

Pode que non sempre haxa coincidencia para cada código. Neses casos, MedlinePlus Connect devolverá unha resposta nula.

A URL base do servizo é: https://connect.medlineplus.gov/service

Estes son dous parámetros necesarios para calquera consulta de proba de laboratorio deste servizo:

1. Sistema de código
   

   Identifique que está a usar o sistema de código LOINC. Uso:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect tamén aceptará:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Código
   identifique o código real que intenta buscar:
   mainSearchCriteria.v.c = 3187-2

Parámetros opcionais

Título do código

Tamén podes identificar o nome da proba de laboratorio. Non obstante, esta información non afecta á resposta. mainSearchCriteria.v.dn = Ensaio do factor IX

Vexa a sección anterior sobre Parámetros de saída para máis detalles sobre o idioma e os formatos de saída.

Descrición dos elementos do átomo seleccionados (ou obxectos JSON) en resposta ás solicitudes de proba de laboratorio

Elemento	Descrición
título	Título da páxina de probas de laboratorio de MedlinePlus
ligazón	URL da páxina de probas de laboratorio de MedlinePlus coincidentes
resumo	Fragmento do contido da páxina
autor	Atribución de orixe para o contido da proba de laboratorio

Exemplos de solicitudes de probas de laboratorio

Para solicitar información para un falante de inglés, a súa solicitude pode parecer unha das seguintes: 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 = gl

Para solicitar información para un falante de español, a súa solicitude pode parecer unha das seguintes: 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 a sobrecarga dos servidores MedlinePlus, NLM require que os usuarios de MedlinePlus Connect non envíen máis de 100 solicitudes por minuto por enderezo IP. As solicitudes que superen este límite non serán atendidas e o servizo non se restablecerá durante 300 segundos ou ata que a taxa de solicitude caia por debaixo do límite, o que veña despois. Para limitar o número de solicitudes que envía a Connect, NLM recomenda resultados de caché durante un período de 12 a 24 horas.

Esta política está en vigor para garantir que o servizo permaneza dispoñible e accesible a todos os usuarios. Se ten un caso de uso específico que require que envíe un gran número de solicitudes a MedlinePlus Connect e, polo tanto, supere o límite de taxa de solicitudes descrito nesta política, póñase en contacto connosco. O persoal de NLM avaliará a súa solicitude e determinará se se pode conceder unha excepción. Revise tamén a documentación dos ficheiros XML de MedlinePlus. Estes ficheiros XML conteñen rexistros completos de temas de saúde e poden servir como método alternativo para acceder aos datos de MedlinePlus.

Máis información