MedlinePlus Connect: serviço da Web
Contente
- Visão geral do serviço da web
- Parâmetros de saída
- Solicitações de códigos de diagnóstico (problema)
- Parâmetros Opcionais
- Descrição dos elementos Atom selecionados (ou objetos JSON) em resposta a solicitações de código de problema
- Exemplos de solicitações de códigos de problema
- Serviços e arquivos relacionados
- Solicitações de informações sobre medicamentos
- Parâmetros Opcionais
- Descrição dos Elementos Atômicos Selecionados (ou objetos JSON) em Resposta a Solicitações de Medicação
- Exemplos de solicitações de códigos de medicamentos
- Solicitações de informações de teste de laboratório
- Parâmetros Opcionais
- Descrição dos elementos Atom selecionados (ou objetos JSON) em resposta a solicitações de teste de laboratório
- Exemplos de solicitações para testes de laboratório
- Política de Utilização Aceitável
- Mais Informações
O MedlinePlus Connect está disponível como um aplicativo da Web ou serviço da Web. Abaixo estão os detalhes técnicos para a implementação do serviço da Web, que responde às solicitações com base em:
Você está convidado a se conectar e exibir os dados retornados pelo MedlinePlus Connect. Você não pode copiar as páginas do MedlinePlus em seu site. Se você usar dados do MedlinePlus Connect Web Service, indique que as informações são do MedlinePlus.gov, mas não use o logotipo MedlinePlus ou de outra forma sugira que o MedlinePlus endossa seu produto específico. Consulte a página da API do NLM para obter mais orientações. Para obter mais informações sobre como criar links para conteúdo do MedlinePlus fora deste serviço, consulte nossas diretrizes e instruções sobre links.
Se você decidir usar o MedlinePlus Connect, cadastre-se na lista de e-mail para acompanhar os desenvolvimentos e trocar ideias com seus colegas. Informe-nos se você implementa o MedlinePlus Connect entrando em contato conosco.
Visão geral do serviço da web
Os parâmetros para as solicitações de serviço da Web estão em conformidade com o Guia de implementação baseado em URL de solicitação de conhecimento HL7 Context-Aware Knowledge Retrieval (Infobutton). A resposta baseada em REST está em conformidade com o Guia de implementação da arquitetura orientada a serviços do HL7 Context-Aware Knowledge Retrieval (Infobutton). A saída da solicitação pode ser XML no formato de feed Atom, JSON ou JSONP.
A estrutura da solicitação indica que tipo de código você está enviando. Em todos os casos, o URL base para o serviço da Web é: https://connect.medlineplus.gov/service
O MedlinePlus Connect usa conexões HTTPS. Solicitações HTTP não serão aceitas e as implementações existentes usando HTTP devem ser atualizadas para HTTPS.
Parâmetros de saída
Esses parâmetros são opcionais. Se você os omitir, a resposta padrão é a informação em inglês no formato XML.
Língua
Identifique se deseja que a resposta seja em inglês ou espanhol. O MedlinePlus Connect presumirá que o inglês é o idioma, se não for especificado.
Se você deseja que a resposta à pesquisa do código do problema seja em espanhol, use: informationRecipient.languageCode.c = es
(= sp também aceita)
Para especificar o inglês, use o seguinte: informationRecipient.languageCode.c = en
Formato
Identifique se deseja que o formato de resposta seja XML, JSON ou JSONP. XML é o padrão.
- Para solicitar JSON, use:
- KnowledgeResponseType = application / json
- Para JSONP, use:
- KnowledgeResponseType = application / javascript & callback = CallbackFunction onde CallbackFunction é um nome que você dá à função de retorno de chamada.
- Para uma resposta em XML, use:
- KnowledgeResponseType = text / xml ou deixe o parâmetro knowledgeResponseType fora da solicitação.
Solicitações de códigos de diagnóstico (problema)
Para um código de problema, o MedlinePlus Connect retornará links e informações das páginas de tópicos de saúde do MedlinePlus, páginas de genética ou páginas de outros Institutos NIH.
O MedlinePlus Connect retornará o seguinte:
Nem sempre pode haver uma correspondência para cada código. Nesses casos, o MedlinePlus Connect retornará uma resposta nula.
O URL base do serviço é: https://connect.medlineplus.gov/service
Existem dois parâmetros obrigatórios para qualquer consulta a este serviço:
- Sistema de Código
Identifique o sistema de código do problema que você usará.- Para uso 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 SNOMED CT use:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Código
Identifique o código real que você está tentando pesquisar:
mainSearchCriteria.v.c = 250,33
Parâmetros Opcionais
Título do Código
Você também pode identificar o nome / cargo do código do problema. No entanto, essas informações não afetam a resposta (ao contrário do aplicativo da Web MedlinePlus Connect, onde as informações de nome / título podem ser usadas). mainSearchCriteria.v.dn = Diabetes mellitus com outro coma tipo 1 não controlado Consulte a seção acima em Parâmetros de saída para obter detalhes sobre o idioma e formatos de saída.
Descrição dos elementos Atom selecionados (ou objetos JSON) em resposta a solicitações de código de problema
| Elemento | Nó de classe | Descrição |
|---|---|---|
| título | Título da página de tópico de saúde MedlinePlus correspondente ou página GHR | |
| link | URL para a página de tópico de saúde MedlinePlus ou página GHR correspondente | |
| resumo | O resumo completo do tópico de saúde. Isso inclui links incorporados para outros tópicos de saúde relevantes e toda a formatação, incluindo marcadores e espaçamento de parágrafo. O resumo está em HTML. Para páginas GHR, a primeira seção da página completa é fornecida. | |
| resumo | Sinônimos para o tópico. Eles são chamados de "Também chamados" na página de um tópico de saúde. Nem todos os tópicos têm termos "Também chamados". | |
| resumo | Reconhecimento de atribuição para o texto do resumo, se a maior parte do resumo for de outra agência federal. Nem todos os resumos têm uma atribuição. O texto não atribuído é original do MedlinePlus. | |
| resumo | Links selecionados associados ao tópico. Isso inclui o nome da página, URL e organização associada (quando aplicável). Os links são formatados em uma lista com marcadores. Nem todos os tópicos possuem esses links. O número de links pode variar de zero a dezenas. |
Exemplos de solicitações de códigos de problema
Uma solicitação completa de Diabetes Mellitus com outro coma tipo 1 não controlado, CID-9 código 250.33, para um paciente que fala espanhol, teria o seguinte endereço 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% 20com% 20other% 20coma% 20type% 201% 20uncontrolled & informationRecipient.languageCode.c = es
Um paciente com o mesmo diagnóstico, mas o formato solicitado é JSON e o idioma é inglês: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json
Um paciente com diagnóstico de "Pneumonia devido a Pseudomonas" usando 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% 28 desordem% 29 & informationRecipient.languageCode.c = en
Um paciente com o mesmo diagnóstico mas 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=Callback=Callback
Serviços e arquivos relacionados
Para receber tópicos de saúde do MedlinePlus em resposta a solicitações de texto, em vez de códigos de problemas, investigue o serviço da Web MedlinePlus. Além disso, se você precisar do conjunto completo de tópicos de saúde do MedlinePlus em formato XML, consulte nossa página de arquivos XML.
Solicitações de informações sobre medicamentos
O MedlinePlus Connect fornece as melhores correspondências de informações sobre medicamentos ao receber uma RXCUI. Também fornece bons resultados ao receber um código NDC. O MedlinePlus Connect pode fornecer respostas em inglês ou espanhol.
Para solicitações de informações sobre medicamentos em inglês, se você não enviar um NDC ou RXCUI ou se não encontrarmos correspondência com base no código, o aplicativo usará a sequência de texto enviada para exibir a melhor correspondência de informações do medicamento. Para solicitações de informações sobre medicamentos em espanhol, o MedlinePlus Connect responde apenas a NDCs ou RXCUIs e não usa strings de texto. É possível ter uma resposta em inglês, mas nenhuma resposta em espanhol.
O serviço da Web MedlinePlus Connect retornará o seguinte:
Pode haver várias respostas para uma solicitação de medicamento. Nem sempre pode haver uma correspondência para cada solicitação. Nesses casos, o MedlinePlus Connect retornará uma resposta nula.
Para solicitações de informações sobre medicamentos, o URL base é: https://connect.medlineplus.gov/service
Para enviar uma solicitação, inclua estas informações:
- Sistema de Código
Identifique o tipo de código de medicamento que você está enviando. (Obrigatório para inglês e espanhol)- Para uso RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Para uso do NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Código
Identifique o código real que você está tentando pesquisar. (Preferido para inglês, obrigatório para espanhol)
mainSearchCriteria.v.c = 637188 - Nome do Medicamento
Identifique o nome do medicamento com uma sequência de texto. (Opcional para inglês, não usado para espanhol)
mainSearchCriteria.v.dn = Chantix 0,5 MG comprimido oral
Parâmetros Opcionais
Título do CódigoAo enviar uma solicitação de informações em inglês, você pode incluir o parâmetro opcional do nome do medicamento. Isso é detalhado na seção acima. mainSearchCriteria.v.dn = Chantix 0,5 MG comprimido oral
Consulte a seção acima em Parâmetros de saída para obter detalhes sobre o idioma e os formatos de saída.
Descrição dos Elementos Atômicos Selecionados (ou objetos JSON) em Resposta a Solicitações de Medicação
| Elemento | Descrição |
|---|---|
| título | Título para a página de medicação MedlinePlus correspondente |
| link | URL para a página de medicação MedlinePlus correspondente |
| autor | Atribuição de fonte para informações de medicação |
Exemplos de solicitações de códigos de medicamentos
Sua solicitação de informações sobre medicamentos deve ser semelhante a uma das seguintes.
Para solicitar informações por um RXCUI, sua solicitação deve ser semelhante a: 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 = en
Para solicitar informações de um NDC para um falante de espanhol, sua solicitação deve ser semelhante a: 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 uma sequência de texto sem um código de medicamento, você deve identificar sua consulta como uma solicitação do tipo NDC para que o MedlinePlus Connect saiba que você está procurando informações sobre o medicamento. Isso funcionará apenas para solicitações em inglês. Sua solicitação pode ser assim: 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
Solicitações de informações de teste de laboratório
O MedlinePlus Connect fornece correspondências com informações de teste de laboratório ao receber uma solicitação LOINC. O serviço pode fornecer uma resposta em inglês ou espanhol.
O serviço da Web MedlinePlus Connect retornará o seguinte:
Nem sempre pode haver uma correspondência para cada código. Nesses casos, o MedlinePlus Connect retornará uma resposta nula.
O URL base do serviço é: https://connect.medlineplus.gov/service
Estes são dois parâmetros obrigatórios para qualquer consulta de teste de laboratório para este serviço:
- Sistema de Código
- Identifique que você está usando o sistema de código LOINC. Usar:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- O MedlinePlus Connect também aceita:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Código
identifique o código real que você está tentando procurar:
mainSearchCriteria.v.c = 3187-2
Parâmetros Opcionais
Título do CódigoVocê também pode identificar o nome do teste de laboratório. No entanto, essas informações não afetam a resposta. mainSearchCriteria.v.dn = Ensaio do fator IX
Consulte a seção acima em Parâmetros de saída para obter detalhes sobre o idioma e os formatos de saída.
Descrição dos elementos Atom selecionados (ou objetos JSON) em resposta a solicitações de teste de laboratório
| Elemento | Descrição |
|---|---|
| título | Título da página de teste de laboratório MedlinePlus correspondente |
| link | URL para a página de teste de laboratório MedlinePlus correspondente |
| resumo | Snippet do conteúdo da página |
| autor | Atribuição de fonte para o conteúdo do teste de laboratório |
Exemplos de solicitações para testes de laboratório
Para solicitar informações para um falante de inglês, sua solicitação pode ser semelhante a uma 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 = en
Para solicitar informações para um falante de espanhol, sua solicitação pode ser semelhante a uma 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 = es
Política de Utilização Aceitável
Para evitar sobrecarregar os servidores MedlinePlus, o NLM exige que os usuários do MedlinePlus Connect não enviem mais de 100 solicitações por minuto por endereço IP. As solicitações que excederem esse limite não serão atendidas e o serviço não será restaurado por 300 segundos ou até que a taxa de solicitações caia abaixo do limite, o que ocorrer depois. Para limitar o número de solicitações que você envia ao Connect, o NLM recomenda o armazenamento em cache dos resultados por um período de 12 a 24 horas.
Esta política existe para garantir que o serviço permaneça disponível e acessível a todos os usuários. Se você tiver um caso de uso específico que requeira o envio de um grande número de solicitações ao MedlinePlus Connect e, portanto, exceder o limite de taxa de solicitação descrito nesta política, entre em contato conosco. A equipe do NLM avaliará sua solicitação e determinará se uma exceção pode ser concedida. Consulte também a documentação dos arquivos XML do MedlinePlus. Esses arquivos XML contêm registros completos de tópicos de saúde e podem servir como um método alternativo de acesso aos dados do MedlinePlus.
Mais Informações
Interessante
Prevenção da anemia falciforme
