MedlinePlus Connect : Application Web
Contenu
- Présentation de l'application Web
- Demandes de codes de diagnostic (problème)
- Paramètres facultatifs
- Exemples de demandes de codes de problème
- Demandes d'informations sur les médicaments
- Paramètres facultatifs
- Exemples de demandes de codes de médicaments
- Demandes d'informations sur les tests de laboratoire
- Paramètres facultatifs
- 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. Voici les détails techniques pour la mise en œuvre de l'application Web, qui répond aux demandes basées sur :
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. Vous pouvez créer un lien vers et afficher les données fournies par MedlinePlus Connect. 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.
Présentation de l'application Web
L'API pour l'application Web est conforme à la spécification d'implémentation basée sur l'URL de la demande de connaissances HL7. La structure de la demande indique quel type de code vous envoyez. Dans tous les cas, l'URL de base de l'application Web est : https://connect.medlineplus.gov/application
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.
Demandes de codes de diagnostic (problème)
MedlinePlus Connect fait correspondre les codes ICD-10-CM, ICD-9-CM ou SNOMED CT aux pages thématiques MedlinePlus liées à la santé, aux pages génétiques ou aux pages d'autres instituts du NIH. Par exemple, un patient diagnostiqué avec le code CIM-9-CM 493.12, Asthme extrinsèque avec exacerbation, pourrait se voir présenter un lien dans un dossier de santé électronique (DSE) qui mène à la page MedlinePlus Asthme.
Pour les demandes par problème, l'URL de base de l'application est : https://connect.medlineplus.gov/applicationCe lien affiche une page avec un champ de recherche vide. Il y a deux paramètres requis pour toute requête sur cette application :
- 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
- Identifiez le code réel que vous essayez de rechercher :
mainSearchCriteria.v.c=250.33
Paramètres facultatifs
Identifiez le nom/titre du code du problème. L'envoi d'aucun code entraînera une requête vers le moteur de recherche MedlinePlus. Si vous spécifiez un code et le nom/titre du code, mais que MedlinePlus Connect n'a aucun résultat, la page de réponse affichera une zone de recherche MedlinePlus préremplie avec le nom/titre. mainSearchCriteria.v.dn=Diabète sucré avec autre coma de type 1 non contrôlé
Indiquez si vous souhaitez que la demande 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
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/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%20uncontroled&informationRecipient.languageCode.c=es
Un patient diagnostiqué avec « Pneumonie due à Pseudomonas » à l'aide du code SNOMED CT 41381004 : https://connect.medlineplus.gov/application?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
Une requête de forme libre, sans système de code ni code de problème, utilisera le moteur de recherche MedlinePlus (en anglais uniquement) : https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
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 aux demandes de code de médicament en anglais ou en espagnol et renverra un lien vers une page de résultats avec les meilleures correspondances des informations sur le médicament MedlinePlus.
Pour les demandes d'informations sur les médicaments en anglais, si vous n'envoyez pas de code NDC ou RXCUI ou si nous ne trouvons aucune correspondance sur la base du code, nous utiliserons 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 ne répond qu'aux NDC ou RXCUI ; il 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.
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. Si MedlinePlus Connect trouve une réponse nulle pour une demande de médicament, le programme affiche une zone de recherche pour le site MedlinePlus. Un utilisateur peut saisir le nom d'un médicament et obtenir une bonne réponse.
Pour les demandes d'informations sur les médicaments, l'URL de base est : https://connect.medlineplus.gov/application
Les demandes d'informations sur les médicaments en anglais et en espagnol ont des exigences différentes. Pour envoyer une demande, incluez ces informations :
- 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
- Identifiez le code réel que vous essayez de rechercher. (Préféré pour l'anglais, requis pour l'espagnol)
mainSearchCriteria.v.c=637188 - 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
Pour les demandes en anglais, vous devez au minimum identifier le système de code et le code, ou le système de code et le nom du médicament. Envoyez les trois pour de meilleurs résultats pour les demandes en anglais. Pour les demandes espagnoles, vous devez identifier le système de code et le code.
Paramètres facultatifs
Lors 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. Ce paramètre n'est pas utilisé pour les requêtes espagnoles.
Indiquez si vous souhaitez que la demande 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 de médicament soit en espagnol, utilisez : informationRecipient.languageCode.c=es (=sp également accepté)
Pour spécifier l'anglais, utilisez ce qui suit : informationRecipient.languageCode.c=en
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/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=fr
Pour demander des informations par un NDC pour un hispanophone, votre demande doit ressembler à ceci : https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-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 ne fonctionnera que pour l'anglais. Votre demande pourrait ressembler à ceci : 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 =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. MedlinePlus Connect peut fournir des réponses aux demandes de test de laboratoire en anglais ou en espagnol et renverra un lien vers une page de résultats avec les meilleures correspondances des informations de test de laboratoire MedlinePlus.
Pour les demandes d'informations sur les tests de laboratoire, l'URL de base est : https://connect.medlineplus.gov/application
Voici deux paramètres obligatoires pour toute requête de test en laboratoire sur cette application :
- Identifiez que vous utilisez le système de code LOINC.
- Pour l'utilisation de LOINC :
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.1
- MedlinePlus Connect acceptera également :
- mainSearchCriteria.v.cs=2.16.840.1.113883.11.79
- Identifiez le code réel que vous essayez de rechercher.
MainSearchCriteria.v.c=3187-2
Paramètres facultatifs
Identifiez le nom/titre du test de laboratoire. Cependant, cette information n'a pas d'impact sur la réponse. mainSearchCriteria.v.dn=Essai du facteur IX
Indiquez si vous souhaitez que la demande 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 du code du 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
Une requête de forme libre, sans système de code ni code de laboratoire, utilisera le moteur de recherche MedlinePlus. Cette approche est plus efficace avec les diagnostics (voir les informations sur le code de problème ci-dessus) au lieu des chaînes de texte de test en laboratoire. Votre demande d'informations sur les tests de laboratoire doit ressembler à l'un des éléments suivants.
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/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 =fr
Pour demander des informations pour un hispanophone, votre demande peut ressembler à l'un des éléments suivants : 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
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.