MedlinePlus Connect: Webanwendung
Inhalt
- Übersicht über die Webanwendung
- Anfragen für Diagnose-(Problem-)Codes
- Optionale Parameter
- Beispiele für Anfragen nach Problemcodes
- Anfragen nach Arzneimittelinformationen
- Optionale Parameter
- Beispiele für Anfragen nach Arzneimittelcodes
- Anfragen für Labortestinformationen
- Optionale Parameter
- Beispiele für Anfragen für Labortests
- Richtlinien zur akzeptablen Nutzung
- Mehr Informationen
MedlinePlus Connect ist als Webanwendung oder Webservice verfügbar. Nachfolgend finden Sie die technischen Details zur Implementierung der Webanwendung, die auf Anfragen reagiert, basierend auf:
Wenn Sie sich für MedlinePlus Connect entscheiden, tragen Sie sich in die E-Mail-Liste ein, um auf dem Laufenden zu bleiben und sich mit Ihren Kollegen auszutauschen. Bitte teilen Sie uns mit, wenn Sie MedlinePlus Connect implementieren, indem Sie uns kontaktieren. Gerne können Sie die von MedlinePlus Connect bereitgestellten Daten verlinken und anzeigen. Weitere Informationen zum Verlinken auf MedlinePlus-Inhalte außerhalb dieses Dienstes finden Sie in unseren Richtlinien und Anweisungen zum Verlinken.
Übersicht über die Webanwendung
Die API für die Webanwendung entspricht der HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation Spezifikation. Die Struktur der Anfrage gibt an, welche Art von Code Sie senden. In allen Fällen lautet die Basis-URL für die Webanwendung: https://connect.medlineplus.gov/application
MedlinePlus Connect verwendet HTTPS-Verbindungen. HTTP-Anfragen werden nicht akzeptiert und vorhandene Implementierungen, die HTTP verwenden, sollten auf HTTPS aktualisiert werden.
Anfragen für Diagnose-(Problem-)Codes
MedlinePlus Connect gleicht ICD-10-CM-, ICD-9-CM- oder SNOMED-CT-Codes mit verwandten MedlinePlus-Gesundheitsthemenseiten, Genetikseiten oder Seiten anderer NIH-Institute ab. Beispielsweise könnte einem Patienten, bei dem der ICD-9-CM-Code 493.12, Extrinsisches Asthma mit Exazerbation, diagnostiziert wurde, ein Link in einer elektronischen Gesundheitsakte (EHR) präsentiert werden, der zur MedlinePlus-Seite Asthma führt.
Für Anfragen nach Problem lautet die Basis-URL der Anwendung: https://connect.medlineplus.gov/applicationDieser Link zeigt eine Seite mit einem leeren Suchfeld an. Für jede Abfrage an diese Anwendung sind zwei erforderliche Parameter erforderlich:
- Identifizieren Sie das Problemcodesystem, das Sie verwenden werden.
- Für ICD-10-CM verwenden:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.90
- Für ICD-9-CM verwenden:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.103
- Für SNOMED CT-Verwendung:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.96
- Identifizieren Sie den tatsächlichen Code, den Sie suchen möchten:
mainSearchCriteria.v.c=250.33
Optionale Parameter
Identifizieren Sie den Namen/Titel des Problemcodes. Wenn Sie keinen Code senden, wird eine Abfrage an die MedlinePlus-Suchmaschine ausgegeben. Wenn Sie einen Code und den Namen/Titel des Codes angeben, MedlinePlus Connect jedoch keine Ergebnisse liefert, wird auf der Antwortseite ein MedlinePlus-Suchfeld angezeigt, das bereits mit dem Namen/Titel ausgefüllt ist. mainSearchCriteria.v.dn=Diabetes mellitus mit anderem Koma Typ 1 unkontrolliert
Geben Sie an, ob die Anfrage auf Englisch oder Spanisch erfolgen soll. MedlinePlus Connect geht davon aus, dass Englisch die Sprache ist, wenn es nicht angegeben ist.
Wenn Sie möchten, dass die Antwort auf die Problemcode-Suche auf Spanisch ist, verwenden Sie : informationRecipient.languageCode.c=es
(=sp auch akzeptiert)
Um Englisch anzugeben, verwenden Sie Folgendes: informationRecipient.languageCode.c=en
Beispiele für Anfragen nach Problemcodes
Eine vollständige Anfrage für Diabetes mellitus mit anderem unkontrolliertem Koma Typ 1, ICD-9-Code 250.33, für einen spanischsprachigen Patienten hätte die folgende URL-Adresse: 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%20unkontrolliert&informationRecipient.languageCode.c=es
Bei einem Patienten wurde mit dem SNOMED CT-Code 41381004 eine "Pneumonie aufgrund von Pseudomonas" diagnostiziert: 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=de
Eine Freiformanfrage ohne Codesystem oder Problemcode verwendet die MedlinePlus-Suchmaschine (nur auf Englisch): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
Anfragen nach Arzneimittelinformationen
MedlinePlus Connect bietet die besten Übereinstimmungen mit Arzneimittelinformationen, wenn Sie eine RXCUI erhalten. Es liefert auch gute Ergebnisse beim Empfang eines NDC-Codes. MedlinePlus Connect kann Antworten auf Medikationscode-Anfragen in Englisch oder Spanisch geben und gibt einen Link zu einer Ergebnisseite mit den besten Übereinstimmungen aus den MedlinePlus-Medikamenteninformationen zurück.
Wenn Sie bei Anfragen nach englischen Arzneimittelinformationen keinen NDC- oder RXCUI-Code senden oder wir aufgrund des Codes keine Übereinstimmung finden, verwenden wir die von Ihnen gesendete Textzeichenfolge, um die beste Übereinstimmung der Arzneimittelinformationen anzuzeigen. Bei Anfragen nach spanischen Arzneimittelinformationen antwortet MedlinePlus Connect nur auf NDCs oder RXCUIs; es verwendet keine Textzeichenfolgen. Es ist möglich, eine Antwort auf Englisch zu erhalten, aber keine Antwort auf Spanisch.
Es kann mehrere Antworten auf eine Medikamentenanfrage geben. Möglicherweise gibt es nicht immer für jede Anfrage eine Übereinstimmung. Wenn MedlinePlus Connect eine Null-Antwort für eine Medikamentenanfrage findet, zeigt das Programm ein Suchfeld für die MedlinePlus-Site an. Ein Benutzer kann einen Medikamentennamen eingeben und erhält möglicherweise eine gute Antwort.
Für Anfragen zu Arzneimittelinformationen lautet die Basis-URL: https://connect.medlineplus.gov/application
Für Anfragen nach englischen und spanischen Arzneimittelinformationen gelten unterschiedliche Anforderungen. Um eine Anfrage zu senden, geben Sie diese Informationen an:
- Identifizieren Sie die Art des Medikamentencodes, den Sie senden. (Erforderlich für Englisch und Spanisch)
- Für RXCUI-Verwendung:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.88
- Für NDC-Verwendung:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.69
- Identifizieren Sie den tatsächlichen Code, den Sie suchen möchten. (Bevorzugt für Englisch, Erforderlich für Spanisch)
mainSearchCriteria.v.c=637188 - Identifizieren Sie den Namen des Medikaments mit einer Textzeichenfolge. (Optional für Englisch, nicht für Spanisch verwendet)
mainSearchCriteria.v.dn=Chantix 0,5 mg orale Tablette
Bei englischen Anfragen sollten Sie mindestens das Codesystem und den Code oder das Codesystem und den Namen des Arzneimittels angeben. Senden Sie alle drei, um die besten Ergebnisse für englische Anfragen zu erhalten. Bei spanischen Anfragen sollten Sie das Codesystem und den Code identifizieren.
Optionale Parameter
Wenn Sie eine Anfrage nach englischen Informationen senden, können Sie den optionalen Parameter des Namens des Medikaments angeben. Dies ist im obigen Abschnitt detailliert beschrieben. Dieser Parameter wird nicht für spanische Anfragen verwendet.
Geben Sie an, ob die Anfrage auf Englisch oder Spanisch erfolgen soll. MedlinePlus Connect geht davon aus, dass Englisch die Sprache ist, wenn es nicht angegeben ist.
Wenn Sie möchten, dass die Antwort auf die Suche nach dem Medikamentencode auf Spanisch ist, verwenden Sie: informationRecipient.languageCode.c=es (=sp wird auch akzeptiert)
Um Englisch anzugeben, verwenden Sie Folgendes: informationRecipient.languageCode.c=en
Beispiele für Anfragen nach Arzneimittelcodes
Ihre Anfrage zu Arzneimittelinformationen sollte wie folgt aussehen.
Um Informationen von einer RXCUI anzufordern, sollte Ihre Anfrage wie folgt aussehen: 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=de
Um Informationen von einem NDC für einen Spanischsprecher anzufordern, sollte Ihre Anfrage wie folgt aussehen: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39&informationRecipient.languageCode.c=es
Um eine Textzeichenfolge ohne Medikamentencode zu senden, müssen Sie Ihre Anfrage als NDC-Anfrage kennzeichnen, damit MedlinePlus Connect weiß, dass Sie nach Medikamenteninformationen suchen. Dies funktioniert nur für Englisch. Ihre Anfrage könnte so aussehen: 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 =de
Anfragen für Labortestinformationen
MedlinePlus Connect bietet Übereinstimmungen mit Labortestinformationen, wenn eine LOINC-Anfrage empfangen wird. MedlinePlus Connect kann Antworten auf Labortestanfragen auf Englisch oder Spanisch geben und gibt einen Link zu einer Ergebnisseite mit den besten Übereinstimmungen aus den MedlinePlus-Labortestinformationen zurück.
Für Anfragen nach Labortestinformationen lautet die Basis-URL: https://connect.medlineplus.gov/application
Dies sind zwei erforderliche Parameter für jede Labortestabfrage für diese Anwendung:
- Stellen Sie sicher, dass Sie das LOINC-Codesystem verwenden.
- Für LOINC-Gebrauch:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.1
- MedlinePlus Connect akzeptiert auch:
- mainSearchCriteria.v.cs=2.16.840.1.113883.11.79
- Identifizieren Sie den tatsächlichen Code, den Sie suchen möchten.
mainSearchCriteria.v.c=3187-2
Optionale Parameter
Identifizieren Sie den Namen/Titel des Labortests. Diese Informationen haben jedoch keinen Einfluss auf die Antwort. mainSearchCriteria.v.dn=Faktor-IX-Assay
Geben Sie an, ob die Anfrage auf Englisch oder Spanisch erfolgen soll. MedlinePlus Connect geht davon aus, dass Englisch die Sprache ist, wenn es nicht angegeben ist.
Wenn Sie möchten, dass die Antwort auf die Problemcode-Suche auf Spanisch ist, verwenden Sie: informationRecipient.languageCode.c=es (=sp wird auch akzeptiert)
Um Englisch anzugeben, verwenden Sie Folgendes: informationRecipient.languageCode.c=en
Eine Freiformanfrage ohne Codesystem oder Laborcode verwendet die MedlinePlus-Suchmaschine. Dieser Ansatz ist bei Diagnosen (siehe die Informationen zum Problemcode oben) effektiver als bei Textzeichenfolgen für Labortests. Ihre Anfrage zu Labortests sollte wie folgt aussehen.
Beispiele für Anfragen für Labortests
Um Informationen für einen Englischsprachigen anzufordern, kann Ihre Anfrage wie folgt aussehen: 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 =de
Um Informationen für einen Spanischsprachigen anzufordern, kann Ihre Anfrage wie folgt aussehen: 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
Richtlinien zur akzeptablen Nutzung
Um eine Überlastung der MedlinePlus-Server zu vermeiden, verlangt NLM, dass Benutzer von MedlinePlus Connect nicht mehr als 100 Anfragen pro Minute pro IP-Adresse senden. Anfragen, die dieses Limit überschreiten, werden nicht bedient und der Service wird 300 Sekunden lang nicht wiederhergestellt oder bis die Anfragerate unter das Limit fällt, je nachdem, was später eintritt. Um die Anzahl der Anfragen zu begrenzen, die Sie an Connect senden, empfiehlt NLM, die Ergebnisse für einen Zeitraum von 12 bis 24 Stunden zwischenzuspeichern.
Diese Richtlinie soll sicherstellen, dass der Dienst für alle Benutzer verfügbar und zugänglich bleibt. Wenn Sie einen bestimmten Anwendungsfall haben, bei dem Sie eine große Anzahl von Anfragen an MedlinePlus Connect senden müssen und somit die in dieser Richtlinie beschriebene Begrenzung der Anfragerate überschreiten, kontaktieren Sie uns bitte. NLM-Mitarbeiter werden Ihre Anfrage prüfen und entscheiden, ob eine Ausnahme gewährt werden kann. Bitte lesen Sie auch die Dokumentation zu den MedlinePlus-XML-Dateien. Diese XML-Dateien enthalten vollständige Datensätze zu Gesundheitsthemen und können als alternative Methode für den Zugriff auf MedlinePlus-Daten dienen.