MedlinePlus Connect : Webservice
Contenu
- Présentation des services Web
- Paramètres de sortie
- Demandes de codes de diagnostic (problème)
- Paramètres facultatifs
- Description des éléments Atom sélectionnés (ou objets JSON) en réponse aux demandes de code de problème
- Exemples de demandes de codes de problème
- Services et fichiers associés
- Demandes d'informations sur les médicaments
- Paramètres facultatifs
- Description des éléments atomiques sélectionnés (ou objets JSON) en réponse aux demandes de médicaments
- Exemples de demandes de codes de médicaments
- Demandes d'informations sur les tests de laboratoire
- Paramètres facultatifs
- Description des éléments Atom sélectionnés (ou objets JSON) en réponse aux demandes de test en laboratoire
- Exemples de demandes de tests en laboratoire
- Politique d'utilisation acceptable
- Plus d'information
MedlinePlus Connect est disponible sous forme d'application Web ou de service Web. Vous trouverez ci-dessous les détails techniques pour la mise en œuvre du service Web, qui répond aux demandes basées sur :
Vous pouvez créer un lien vers et afficher les données renvoyées par MedlinePlus Connect. Vous ne pouvez pas copier les pages MedlinePlus sur votre site. Si vous utilisez des données du service Web MedlinePlus Connect, veuillez indiquer que les informations proviennent de MedlinePlus.gov mais n'utilisez pas le logo MedlinePlus ou n'impliquez pas que MedlinePlus approuve votre produit particulier. Veuillez consulter la page API de NLM pour plus d'informations. Pour plus d'informations sur la façon de créer un lien vers le contenu MedlinePlus en dehors de ce service, veuillez consulter nos directives et instructions sur la création de liens.
Si vous décidez d'utiliser MedlinePlus Connect, inscrivez-vous à la liste de diffusion pour suivre les développements et échanger des idées avec vos collègues. Veuillez nous indiquer si vous mettez en œuvre MedlinePlus Connect en nous contactant.
Présentation des services Web
Les paramètres des demandes de service Web sont conformes au Guide d'implémentation basé sur URL de la demande de connaissances HL7 Context-Aware Knowledge Retrieval (Infobutton). La réponse basée sur REST est conforme au guide de mise en œuvre de l'architecture orientée services HL7 Context-Aware Knowledge Retrieval (Infobutton). La sortie de la demande peut être XML au format de flux Atom, JSON ou JSONP.
La structure de la demande indique quel type de code vous envoyez. Dans tous les cas, l'URL de base du service Web est : https://connect.medlineplus.gov/service
MedlinePlus Connect utilise des connexions HTTPS. Les requêtes HTTP ne seront pas acceptées et les implémentations existantes utilisant HTTP doivent être mises à jour vers HTTPS.
Paramètres de sortie
Ces paramètres sont facultatifs. Si vous les omettez, la réponse par défaut est des informations en anglais au format XML.
Langue
Indiquez si vous souhaitez que la réponse soit en anglais ou en espagnol. MedlinePlus Connect supposera que l'anglais est la langue si elle n'est pas spécifiée.
Si vous souhaitez que la réponse à la recherche de code problème soit en espagnol, utilisez : informationRecipient.languageCode.c=es
(=sp également accepté)
Pour spécifier l'anglais, utilisez ce qui suit : informationRecipient.languageCode.c=en
Format
Indiquez si vous souhaitez que le format de réponse soit XML, JSON ou JSONP. XML est la valeur par défaut.
- Pour demander JSON, utilisez :
- knowResponseType=application/json
- Pour JSONP, utilisez :
- knowledgeResponseType=application/javascript&callback=CallbackFunction où CallbackFunction est un nom que vous donnez à la fonction de rappel.
- Pour une réponse en XML, utilisez :
- knowledgeResponseType=text/xml ou laissez le paramètre knowledgeResponseType en dehors de la demande.
Demandes de codes de diagnostic (problème)
Pour un code de problème, MedlinePlus Connect renverra des liens et des informations à partir des pages de sujets de santé MedlinePlus, des pages de génétique ou des pages d'autres instituts NIH.
MedlinePlus Connect renverra les éléments suivants :
Il peut ne pas toujours y avoir de correspondance pour chaque code. Dans ces cas, MedlinePlus Connect renverra une réponse nulle.
L'URL de base du service est : https://connect.medlineplus.gov/service
Il y a deux paramètres requis pour toute requête sur ce service :
- Système de code
Identifiez le système de code de problème que vous utiliserez.- Pour l'utilisation de la CIM-10-CM :
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.90
- Pour l'utilisation de la CIM-9-CM :
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.103
- Pour l'utilisation de SNOMED CT :
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.96
- Code
Identifiez le code réel que vous essayez de rechercher :
mainSearchCriteria.v.c=250.33
Paramètres facultatifs
Titre du code
Vous pouvez également identifier le nom/titre du code du problème. Cependant, ces informations n'ont pas d'impact sur la réponse (contrairement à l'application Web MedlinePlus Connect où les informations sur le nom/le titre peuvent être utilisées). mainSearchCriteria.v.dn=Diabète sucré avec autre coma de type 1 non contrôlé Voir la section ci-dessus sur les paramètres de sortie pour plus de détails sur la langue et les formats de sortie.
Description des éléments Atom sélectionnés (ou objets JSON) en réponse aux demandes de code de problème
| Élément | Nœud de classe | La description |
|---|---|---|
| Titre | Titre de la page de sujet de santé MedlinePlus ou de la page GHR correspondante | |
| relier | URL de la page de sujet de santé MedlinePlus ou de la page GHR correspondante | |
| résumé | Le résumé complet du thème de la santé. Cela inclut des liens intégrés vers d'autres sujets de santé pertinents, ainsi que toute la mise en forme, y compris les puces et l'espacement des paragraphes. Le résumé est en HTML. Pour les pages GHR, la première section de la page complète est fournie. | |
| résumé | Synonymes pour le sujet. Ceux-ci sont appelés « Aussi appelé » sur une page de sujet sur la santé. Tous les sujets n'ont pas de termes « Aussi appelé ». | |
| résumé | Reconnaissance d'attribution pour le texte du résumé, si la majorité du résumé provenait d'un autre organisme fédéral. Tous les résumés n'ont pas d'attribution. Le texte non attribué est d'origine MedlinePlus. | |
| résumé | Liens sélectionnés associés au sujet. Cela inclut le nom de la page, l'URL et l'organisation associée (le cas échéant). Les liens sont formatés dans une liste à puces. Tous les sujets n'ont pas ces liens. Le nombre de liens peut aller de zéro à des dizaines. |
Exemples de demandes de codes de problème
Une demande complète de diabète sucré avec autre coma de type 1 non contrôlé, code ICD-9 250.33, pour un patient hispanophone aurait l'adresse URL suivante : 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%20uncontroled&informationRecipient.languageCode.c=es
Un patient avec le même diagnostic mais le format demandé est JSON et la langue est l'anglais : https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application /json
Un patient diagnostiqué avec « Pneumonie due à Pseudomonas » à l'aide du code SNOMED CT 41381004 : https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonie%20due%20to%20Pseudomonas%20%28disorder%29&informationRecipient.languageCode.c=en
Un patient avec le même diagnostic mais le format demandé est JSONP : https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFunction
Services et fichiers associés
Pour recevoir des sujets de santé MedlinePlus en réponse à des demandes de texte, par opposition aux codes de problème, recherchez le service Web MedlinePlus. De plus, si vous avez besoin de l'ensemble complet des sujets de santé MedlinePlus au format XML, consultez notre page de fichiers XML.
Demandes d'informations sur les médicaments
MedlinePlus Connect fournit les meilleures correspondances d'informations sur les médicaments lors de la réception d'un RXCUI. Il fournit également de bons résultats lors de la réception d'un code NDC. MedlinePlus Connect peut fournir des réponses en anglais ou en espagnol.
Pour les demandes d'informations sur les médicaments en anglais, si vous n'envoyez pas de NDC ou de RXCUI ou si nous ne trouvons aucune correspondance sur la base du code, l'application utilisera la chaîne de texte que vous envoyez pour afficher la meilleure correspondance d'informations sur les médicaments. Pour les demandes d'informations sur les médicaments en espagnol, MedlinePlus Connect répond uniquement aux NDC ou aux RXCUI et n'utilise pas de chaînes de texte. Il est possible d'avoir une réponse en anglais mais pas de réponse en espagnol.
Le service Web MedlinePlus Connect renverra les éléments suivants :
Il peut y avoir plusieurs réponses à une même demande de médicament. Il peut ne pas toujours y avoir de correspondance pour chaque demande. Dans ces cas, MedlinePlus Connect renverra une réponse nulle.
Pour les demandes d'informations sur les médicaments, l'URL de base est : https://connect.medlineplus.gov/service
Pour envoyer une demande, incluez ces informations :
- Système de codes
Identifiez le type de code de médicament que vous envoyez. (Requis pour l'anglais et l'espagnol)- Pour l'utilisation de RXCUI :
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.88
- Pour une utilisation NDC :
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.69
- Code
Identifiez le code réel que vous essayez de rechercher. (Préféré pour l'anglais, requis pour l'espagnol)
mainSearchCriteria.v.c=637188 - Nom du médicament
Identifiez le nom du médicament avec une chaîne de texte. (Facultatif pour l'anglais, non utilisé pour l'espagnol)
mainSearchCriteria.v.dn=Chantix 0,5 MG Comprimé Oral
Paramètres facultatifs
Titre du codeLors de l'envoi d'une demande d'informations en anglais, vous pouvez inclure le paramètre facultatif du nom du médicament. Ceci est détaillé dans la section ci-dessus. mainSearchCriteria.v.dn=Chantix 0,5 MG Comprimé Oral
Voir la section ci-dessus sur les paramètres de sortie pour plus de détails sur la langue et les formats de sortie.
Description des éléments atomiques sélectionnés (ou objets JSON) en réponse aux demandes de médicaments
| Élément | La description |
|---|---|
| Titre | Titre de la page des médicaments MedlinePlus correspondants |
| relier | URL de la page des médicaments MedlinePlus correspondants |
| auteur | Attribution de la source pour les informations sur les médicaments |
Exemples de demandes de codes de médicaments
Votre demande d'informations sur les médicaments devrait ressembler à l'une des suivantes.
Pour demander des informations par un RXCUI, votre demande doit ressembler à ceci : 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
Pour demander des informations par un NDC pour un hispanophone, votre demande doit ressembler à ceci : https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39&informationRecipient.languageCode.c=es
Pour envoyer une chaîne de texte sans code de médicament, vous devez identifier votre requête comme une demande de type NDC afin que MedlinePlus Connect sache que vous recherchez des informations sur les médicaments. Cela fonctionnera uniquement pour les demandes en anglais. Votre demande pourrait ressembler à ceci : 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 =fr
Demandes d'informations sur les tests de laboratoire
MedlinePlus Connect fournit des correspondances avec les informations des tests de laboratoire lors de la réception d'une demande LOINC. Le service peut fournir une réponse en anglais ou en espagnol.
Le service Web MedlinePlus Connect renverra les éléments suivants :
Il peut ne pas toujours y avoir de correspondance pour chaque code. Dans ces cas, MedlinePlus Connect renverra une réponse nulle.
L'URL de base du service est : https://connect.medlineplus.gov/service
Voici deux paramètres obligatoires pour toute requête de test de laboratoire vers ce service :
- Système de codes
- Identifiez que vous utilisez le système de code LOINC. Utiliser:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.1
- MedlinePlus Connect acceptera également :
- mainSearchCriteria.v.cs=2.16.840.1.113883.11.79
- Code
identifiez le code réel que vous essayez de rechercher :
MainSearchCriteria.v.c=3187-2
Paramètres facultatifs
Titre du codeVous pouvez également identifier le nom du test de laboratoire. Cependant, cette information n'a pas d'impact sur la réponse. mainSearchCriteria.v.dn=Essai du facteur IX
Voir la section ci-dessus sur les paramètres de sortie pour plus de détails sur la langue et les formats de sortie.
Description des éléments Atom sélectionnés (ou objets JSON) en réponse aux demandes de test en laboratoire
| Élément | La description |
|---|---|
| Titre | Titre de la page de test de laboratoire MedlinePlus correspondante |
| relier | URL de la page de test de laboratoire MedlinePlus correspondante |
| résumé | Extrait du contenu de la page |
| auteur | Attribution de la source pour le contenu du test de laboratoire |
Exemples de demandes de tests en laboratoire
Pour demander des informations pour un anglophone, votre demande peut ressembler à l'un des éléments suivants : 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 =fr
Pour demander des informations pour un hispanophone, votre demande peut ressembler à l'un des éléments suivants : 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
Politique d'utilisation acceptable
Afin d'éviter de surcharger les serveurs MedlinePlus, NLM exige que les utilisateurs de MedlinePlus Connect n'envoient pas plus de 100 requêtes par minute et par adresse IP. Les demandes qui dépassent cette limite ne seront pas traitées et le service ne sera pas restauré pendant 300 secondes ou jusqu'à ce que le taux de demandes tombe en dessous de la limite, selon la dernière éventualité. Pour limiter le nombre de demandes que vous envoyez à Connect, NLM recommande de mettre les résultats en cache pendant une période de 12 à 24 heures.
Cette politique est en place pour garantir que le service reste disponible et accessible à tous les utilisateurs. Si vous avez un cas d'utilisation spécifique qui vous oblige à envoyer un grand nombre de demandes à MedlinePlus Connect, et dépasse ainsi la limite de taux de demande décrite dans cette politique, veuillez nous contacter. Le personnel de NLM évaluera votre demande et déterminera si une exception peut être accordée. Veuillez également consulter la documentation des fichiers XML MedlinePlus. Ces fichiers XML contiennent des dossiers complets sur les sujets de santé et peuvent servir de méthode alternative pour accéder aux données MedlinePlus.
Plus d'information
Nouvelles Publications
Medicare PPO: Foire aux questions
