Συγγραφέας: Eric Farmer
Ημερομηνία Δημιουργίας: 4 Μάρτιος 2021
Ημερομηνία Ενημέρωσης: 28 Οκτώβριος 2024
Anonim
MedlinePlus Connect: Υπηρεσία Ιστού - Φάρμακο
MedlinePlus Connect: Υπηρεσία Ιστού - Φάρμακο

Περιεχόμενο

Το MedlinePlus Connect διατίθεται ως εφαρμογή Web ή υπηρεσία Web. Ακολουθούν οι τεχνικές λεπτομέρειες για την εφαρμογή της υπηρεσίας Web, η οποία ανταποκρίνεται σε αιτήματα με βάση:

Είστε ευπρόσδεκτοι να συνδέσετε και να εμφανίσετε τα δεδομένα που επιστρέφονται από το MedlinePlus Connect. Δεν μπορείτε να αντιγράψετε σελίδες MedlinePlus στον ιστότοπό σας. Εάν χρησιμοποιείτε δεδομένα από την Υπηρεσία Web MedlinePlus Connect, υποδείξτε ότι οι πληροφορίες προέρχονται από το MedlinePlus.gov, αλλά μην χρησιμοποιείτε το λογότυπο MedlinePlus ή υποδηλώνετε ότι το MedlinePlus υποστηρίζει το συγκεκριμένο προϊόν σας. Για περισσότερες οδηγίες, ανατρέξτε στη σελίδα API του NLM. Για περισσότερες πληροφορίες σχετικά με τον τρόπο σύνδεσης σε περιεχόμενο MedlinePlus εκτός αυτής της υπηρεσίας, ανατρέξτε στις οδηγίες και οδηγίες σχετικά με τη σύνδεση.

Εάν αποφασίσετε να χρησιμοποιήσετε το MedlinePlus Connect, εγγραφείτε στη λίστα email για να παρακολουθείτε τις εξελίξεις και να ανταλλάσσετε ιδέες με τους συναδέλφους σας. Πείτε μας εάν εφαρμόσετε το MedlinePlus Connect επικοινωνώντας μαζί μας.

Επισκόπηση υπηρεσίας Web

Οι παράμετροι για τις αιτήσεις υπηρεσίας Web συμμορφώνονται με τον Οδηγό υλοποίησης βάσει γνώσης URL αιτήματος γνώσης (Infobutton) HL7 Context-Aware. Η απόκριση βασισμένη στο REST συμμορφώνεται με τον Οδηγό υλοποίησης αρχιτεκτονικής προσανατολισμένης στην υπηρεσία HL7 Context-Aware Knowledge Recrieval (Infobutton). Η έξοδος του αιτήματος μπορεί να είναι XML σε μορφή τροφοδοσίας Atom, JSON ή JSONP.


Η δομή του αιτήματος υποδεικνύει τον τύπο κώδικα που στέλνετε. Σε όλες τις περιπτώσεις, η βασική διεύθυνση URL για την υπηρεσία Ιστού είναι: https://connect.medlineplus.gov/service

Το MedlinePlus Connect χρησιμοποιεί συνδέσεις HTTPS. Τα αιτήματα HTTP δεν θα γίνονται αποδεκτά και οι υπάρχουσες εφαρμογές που χρησιμοποιούν HTTP θα πρέπει να ενημερώνονται σε HTTPS.

Παράμετροι εξόδου

Αυτές οι παράμετροι είναι προαιρετικές. Εάν τα αφήσετε έξω, η προεπιλεγμένη απάντηση είναι οι πληροφορίες στα Αγγλικά σε μορφή XML.

Γλώσσα
Προσδιορίστε αν θέλετε η απάντηση να είναι στα Αγγλικά ή στα Ισπανικά. Το MedlinePlus Connect θα υποθέσει ότι τα Αγγλικά είναι η γλώσσα εάν δεν προσδιορίζεται.

Εάν θέλετε η απάντηση στην αναζήτηση κωδικού προβλήματος να είναι στα Ισπανικά, χρησιμοποιήστε: informationRecipient.languageCode.c = es
(= αποδεκτή sp)

Για να καθορίσετε Αγγλικά, χρησιμοποιήστε τα εξής: informationRecipient.languageCode.c = en

Μορφή
Προσδιορίστε αν θέλετε η μορφή απόκρισης να είναι XML, JSON ή JSONP. Το XML είναι η προεπιλογή.

Για να ζητήσετε JSON, χρησιμοποιήστε:
knowledgeResponseType = εφαρμογή / json
Για το JSONP, χρησιμοποιήστε:
knowledgeResponseType = application / javascript & callback = CallbackFunction όπου CallbackFunction είναι ένα όνομα που δίνετε στη λειτουργία επιστροφής κλήσης.
Για μια απάντηση σε XML, χρησιμοποιήστε:
knowledgeResponseType = κείμενο / xml ή αφήστε την παράμετρο knowledgeResponseType εκτός αιτήματος.


Αιτήματα για κωδικούς διάγνωσης (Πρόβλημα)

Για έναν κωδικό προβλήματος, το MedlinePlus Connect θα επιστρέψει συνδέσμους και πληροφορίες από σελίδες θεμάτων υγείας MedlinePlus, σελίδες γενετικής ή σελίδες από άλλα Ινστιτούτα NIH.

Το MedlinePlus Connect θα επιστρέψει τα ακόλουθα:

Μπορεί να μην υπάρχει πάντα αντιστοιχία για κάθε κωδικό. Σε αυτές τις περιπτώσεις, το MedlinePlus Connect θα επιστρέψει μια μηδενική απόκριση.

Η βασική διεύθυνση URL της υπηρεσίας είναι: https://connect.medlineplus.gov/service

Υπάρχουν δύο απαιτούμενες παράμετροι για οποιοδήποτε ερώτημα σε αυτήν την υπηρεσία:

  1. Σύστημα κώδικα
    Προσδιορίστε το σύστημα κωδικών προβλημάτων που θα χρησιμοποιείτε.
    Για χρήση ICD-10-CM:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
    Για χρήση ICD-9-CM:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
    Για χρήση SNOMED CT:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
  2. Κώδικας
    Προσδιορίστε τον πραγματικό κωδικό που προσπαθείτε να αναζητήσετε:
    mainSearchCriteria.v.c = 250.33


Προαιρετικές παράμετροι

Τίτλος κώδικα
Μπορείτε επίσης να προσδιορίσετε το όνομα / τον τίτλο του κωδικού προβλήματος. Ωστόσο, αυτές οι πληροφορίες δεν επηρεάζουν την απόκριση (σε αντίθεση με την εφαρμογή MedlinePlus Connect Web όπου μπορούν να χρησιμοποιηθούν οι πληροφορίες ονόματος / τίτλου). mainSearchCriteria.v.dn = Σακχαρώδης διαβήτης με άλλους ανεξέλεγκτους κώμα τύπου 1 Δείτε την παραπάνω ενότητα σχετικά με τις παραμέτρους εξόδου για λεπτομέρειες σχετικά με τη μορφή γλώσσας και εξόδου.

Περιγραφή επιλεγμένων στοιχείων Atom (ή αντικειμένων JSON) στην απάντηση σε αιτήματα κωδικού προβλήματος

ΣτοιχείοΚόμβος κλάσηςΠεριγραφή
τίτλος Τίτλος της αντιστοιχισμένης σελίδας υγείας MedlinePlus ή της σελίδας GHR
Σύνδεσμος Διεύθυνση URL για αντιστοιχισμένη σελίδα θεμάτων υγείας MedlinePlus ή σελίδα GHR
περίληψη Η πλήρης περίληψη για το θέμα της υγείας. Αυτό περιλαμβάνει ενσωματωμένους συνδέσμους προς άλλα σχετικά θέματα υγείας και όλες τις μορφές, συμπεριλαμβανομένων κουκκίδων και διαχωριστικών παραγράφων. Η περίληψη είναι σε HTML. Για τις σελίδες GHR, παρέχεται η πρώτη ενότητα της πλήρους σελίδας.
περίληψηΣυνώνυμα για το θέμα. Αυτά αναφέρονται ως "Επίσης ονομάζεται" σε μια σελίδα θεμάτων υγείας. Δεν έχουν όλα τα θέματα όροι "Επίσης ονομάζονται".
περίληψηΑπόδειξη αναγνώρισης για συνοπτικό κείμενο, εάν η πλειοψηφία της περίληψης προέρχεται από άλλο ομοσπονδιακό γραφείο. Δεν έχουν όλες οι περιλήψεις μια απόδοση. Το μη κατανεμημένο κείμενο είναι πρωτότυπο στο MedlinePlus.
περίληψηΕπιλεγμένοι σύνδεσμοι που σχετίζονται με το θέμα. Αυτό περιλαμβάνει το όνομα της σελίδας, τη διεύθυνση URL και τον σχετικό οργανισμό (κατά περίπτωση). Οι σύνδεσμοι είναι μορφοποιημένοι σε μια λίστα με κουκκίδες. Δεν έχουν όλα τα θέματα αυτά οι σύνδεσμοι. Ο αριθμός των συνδέσμων μπορεί να κυμαίνεται από μηδέν έως δεκάδες.

Παραδείγματα αιτημάτων για κωδικούς προβλήματος

Ένα πλήρες αίτημα για σακχαρώδη διαβήτη με άλλους ανεξέλεγκτους κώμα τύπου 1, κωδικό ICD-9 250.33, για έναν Ισπανόφωνο ασθενή θα έχει την ακόλουθη διεύθυνση 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

Ένας ασθενής με την ίδια διάγνωση, αλλά η απαιτούμενη μορφή είναι JSON και η γλώσσα είναι η αγγλική: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Ένας ασθενής που διαγνώστηκε με "Πνευμονία λόγω ψευδομονάδας" χρησιμοποιώντας τον κωδικό CT SNOMED 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v Πνευμονία% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = en

Ένας ασθενής με την ίδια διάγνωση αλλά η απαιτούμενη μορφή είναι JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&call

Σχετικές υπηρεσίες και αρχεία

Για να λάβετε θέματα υγείας MedlinePlus ως απάντηση σε αιτήματα κειμένου, σε αντίθεση με τους κωδικούς προβλημάτων, διερευνήστε την υπηρεσία Web MedlinePlus. Επίσης, εάν χρειάζεστε το πλήρες σύνολο θεμάτων υγείας MedlinePlus σε μορφή XML, δείτε τη σελίδα αρχείων XML.

Αιτήματα για πληροφορίες σχετικά με τα ναρκωτικά

Το MedlinePlus Connect παρέχει τους καλύτερους αγώνες πληροφοριών για τα ναρκωτικά όταν λαμβάνετε RXCUI. Παρέχει επίσης καλά αποτελέσματα κατά τη λήψη ενός κωδικού NDC. Το MedlinePlus Connect μπορεί να παρέχει απαντήσεις στα Αγγλικά ή στα Ισπανικά.

Για αιτήματα για πληροφορίες σχετικά με τα φάρμακα στα Αγγλικά, εάν δεν στείλετε NDC ή RXCUI ή αν δεν βρούμε αντιστοιχία με βάση τον κωδικό, η εφαρμογή θα χρησιμοποιήσει τη συμβολοσειρά κειμένου που στέλνετε για να εμφανιστεί η καλύτερη αντιστοίχιση πληροφοριών για φάρμακα. Για αιτήματα πληροφοριών ισπανικής φαρμακευτικής αγωγής, το MedlinePlus Connect ανταποκρίνεται μόνο σε NDC ή RXCUI και δεν χρησιμοποιεί συμβολοσειρές κειμένου. Είναι πιθανό να υπάρχει απάντηση στα αγγλικά αλλά καμία απάντηση στα ισπανικά.

Η υπηρεσία MedlinePlus Connect Web θα επιστρέψει τα ακόλουθα:

Μπορεί να υπάρχουν πολλαπλές απαντήσεις σε ένα αίτημα φαρμακευτικής αγωγής. Μπορεί να μην υπάρχει πάντα αντιστοιχία για κάθε αίτημα. Σε αυτές τις περιπτώσεις, το MedlinePlus Connect θα επιστρέψει μια μηδενική απόκριση.

Για αιτήματα για πληροφορίες σχετικά με τα ναρκωτικά, η βασική διεύθυνση URL είναι: https://connect.medlineplus.gov/service

Για να στείλετε ένα αίτημα, συμπεριλάβετε αυτά τα στοιχεία:

  1. Σύστημα κώδικα
    Προσδιορίστε τον τύπο του κωδικού φαρμάκου που στέλνετε. (Απαιτείται για Αγγλικά και Ισπανικά)
    Για χρήση RXCUI:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
    Για χρήση NDC:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
    Το MedlinePlus Connect μπορεί επίσης να δεχτεί μια συμβολοσειρά κειμένου για αιτήματα πληροφοριών φαρμακευτικής αγωγής στα Αγγλικά, αλλά πρέπει να υποδείξετε ότι αναζητάτε πληροφορίες φαρμακευτικής αγωγής συμπεριλαμβάνοντας ένα από τα δύο συστήματα κώδικα που αναφέρονται παραπάνω.
  2. Κώδικας
    Προσδιορίστε τον πραγματικό κωδικό που προσπαθείτε να αναζητήσετε. (Προτιμάται για Αγγλικά, Απαιτείται για Ισπανικά)
    mainSearchCriteria.v.c = 637188
  3. Όνομα φαρμάκου
    Προσδιορίστε το όνομα του φαρμάκου με μια συμβολοσειρά κειμένου. (Προαιρετικό για Αγγλικά, Δεν χρησιμοποιείται για Ισπανικά)
    mainSearchCriteria.v.dn = Chantix 0,5 MG Oral Tablet
Τουλάχιστον θα πρέπει να προσδιορίσετε το σύστημα κώδικα και τον κωδικό ή το σύστημα κώδικα και το όνομα του φαρμάκου. Στείλτε και τα τρία για καλύτερα αποτελέσματα για αιτήματα στα Αγγλικά. Στείλτε το σύστημα κώδικα και τον κωδικό για αιτήματα ισπανικών.

Προαιρετικές παράμετροι

Τίτλος κώδικα

Κατά την αποστολή αιτήματος για πληροφορίες στα Αγγλικά, ενδέχεται να συμπεριλάβετε την προαιρετική παράμετρο του ονόματος του φαρμάκου. Αυτό περιγράφεται λεπτομερώς στην παραπάνω ενότητα. mainSearchCriteria.v.dn = Chantix 0,5 MG Oral Tablet

Ανατρέξτε στην παραπάνω ενότητα σχετικά με τις παραμέτρους εξόδου για λεπτομέρειες σχετικά με τη μορφή γλώσσας και εξόδου.

Περιγραφή επιλεγμένων στοιχείων Atom (ή αντικειμένων JSON) στην απόκριση σε αιτήσεις φαρμάκων

ΣτοιχείοΠεριγραφή
τίτλοςΤίτλος για την αντίστοιχη σελίδα φαρμάκων MedlinePlus
ΣύνδεσμοςURL για την αντιστοιχισμένη σελίδα φαρμάκων MedlinePlus
συντάκτηςΑπόδοση πηγής για πληροφορίες φαρμάκων

Παραδείγματα αιτημάτων για κωδικούς ναρκωτικών

Το αίτημά σας για πληροφορίες σχετικά με τα φάρμακα πρέπει να μοιάζει με ένα από τα ακόλουθα.

Για να ζητήσετε πληροφορίες από ένα RXCUI, το αίτημά σας πρέπει να έχει την εξής μορφή: 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% 20 Προφορική% 20Tablet & informationRecipient.languageCode.c = el

Για να ζητήσετε πληροφορίες από ένα NDC για έναν ομιλητή από την Ισπανία, το αίτημά σας πρέπει να έχει την εξής μορφή: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Για να στείλετε μια συμβολοσειρά κειμένου χωρίς κωδικό φαρμακευτικής αγωγής, πρέπει να προσδιορίσετε το ερώτημά σας ως αίτημα τύπου NDC, ώστε το MedlinePlus Connect να γνωρίζει ότι αναζητάτε πληροφορίες φαρμακευτικής αγωγής. Αυτό θα λειτουργήσει μόνο για αιτήματα στα Αγγλικά. Το αίτημά σας μπορεί να έχει την εξής μορφή: 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. = en

Αιτήματα για πληροφορίες εργαστηριακών δοκιμών

Το MedlinePlus Connect παρέχει αντιστοιχίσεις σε πληροφορίες εργαστηριακών δοκιμών όταν λαμβάνει αίτημα LOINC. Η υπηρεσία μπορεί να δώσει απάντηση στα Αγγλικά ή στα Ισπανικά.

Η υπηρεσία MedlinePlus Connect Web θα επιστρέψει τα ακόλουθα:

Μπορεί να μην υπάρχει πάντα αντιστοιχία για κάθε κωδικό. Σε αυτές τις περιπτώσεις, το MedlinePlus Connect θα επιστρέψει μια μηδενική απόκριση.

Η βασική διεύθυνση URL της υπηρεσίας είναι: https://connect.medlineplus.gov/service

Αυτές είναι δύο απαιτούμενες παράμετροι για οποιοδήποτε ερώτημα εργαστηριακής δοκιμής σε αυτήν την υπηρεσία:

  1. Σύστημα κώδικα
    Προσδιορίστε ότι χρησιμοποιείτε το σύστημα κώδικα LOINC. Χρήση:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
    Το MedlinePlus Connect δέχεται επίσης:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
  2. Κώδικας
    προσδιορίστε τον πραγματικό κωδικό που προσπαθείτε να αναζητήσετε:
    mainSearchCriteria.v.c = 3187-2

Προαιρετικές παράμετροι

Τίτλος κώδικα

Μπορείτε επίσης να προσδιορίσετε το όνομα του εργαστηρίου. Ωστόσο, αυτές οι πληροφορίες δεν επηρεάζουν την απάντηση. mainSearchCriteria.v.dn = Δοκιμασία παράγοντα IX

Ανατρέξτε στην παραπάνω ενότητα σχετικά με τις παραμέτρους εξόδου για λεπτομέρειες σχετικά με τη μορφή γλώσσας και εξόδου.

Περιγραφή επιλεγμένων στοιχείων Atom (ή αντικειμένων JSON) στην απόκριση σε αιτήματα δοκιμής εργαστηρίου

ΣτοιχείοΠεριγραφή
τίτλοςΤίτλος της αντιστοιχισμένης δοκιμαστικής σελίδας εργαστηρίου MedlinePlus
ΣύνδεσμοςΔιεύθυνση URL για αντιστοιχισμένη σελίδα δοκιμής εργαστηρίου MedlinePlus
περίληψηΑπόσπασμα από το περιεχόμενο της σελίδας
συντάκτηςΑπόδοση πηγής για το εργαστηριακό περιεχόμενο δοκιμής

Παραδείγματα αιτημάτων για εργαστηριακές δοκιμές

Για να ζητήσετε πληροφορίες για έναν αγγλόφωνο, το αίτημά σας μπορεί να μοιάζει με ένα από τα ακόλουθα: 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 = el https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.cecient. = en

Για να ζητήσετε πληροφορίες για έναν Ισπανό ομιλητή, το αίτημά σας μπορεί να μοιάζει με ένα από τα ακόλουθα: 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&informationRecipientl. = es

Πολιτική αποδεκτής χρήσης

Προκειμένου να αποφευχθεί η υπερφόρτωση των διακομιστών MedlinePlus, η NLM απαιτεί από τους χρήστες του MedlinePlus Connect να στέλνουν όχι περισσότερα από 100 αιτήματα ανά λεπτό ανά διεύθυνση IP. Τα αιτήματα που υπερβαίνουν αυτό το όριο δεν θα εξυπηρετηθούν και η υπηρεσία δεν θα αποκατασταθεί για 300 δευτερόλεπτα ή έως ότου η τιμή αιτήματος πέσει κάτω από το όριο, όποιο συμβεί αργότερα. Για να περιορίσετε τον αριθμό των αιτημάτων που στέλνετε στο Connect, η NLM συνιστά αποτελέσματα προσωρινής αποθήκευσης για περίοδο 12-24 ωρών.

Αυτή η πολιτική ισχύει για να διασφαλιστεί ότι η υπηρεσία παραμένει διαθέσιμη και προσβάσιμη σε όλους τους χρήστες. Εάν έχετε μια συγκεκριμένη περίπτωση χρήσης που απαιτεί να στείλετε μεγάλο αριθμό αιτημάτων στο MedlinePlus Connect και, κατά συνέπεια, να υπερβείτε το όριο του ποσοστού αιτημάτων που περιγράφεται σε αυτήν την πολιτική, επικοινωνήστε μαζί μας. Το προσωπικό της NLM θα αξιολογήσει το αίτημά σας και θα καθορίσει εάν μπορεί να χορηγηθεί εξαίρεση. Διαβάστε επίσης την τεκμηρίωση αρχείων MedlinePlus XML. Αυτά τα αρχεία XML περιέχουν πλήρη αρχεία θεμάτων υγείας και μπορούν να χρησιμεύσουν ως εναλλακτική μέθοδος πρόσβασης στα δεδομένα MedlinePlus.

Περισσότερες πληροφορίες

Για Σενα

Baker's (Popliteal) Cyst

Baker's (Popliteal) Cyst

Μια popliteal κύστη, επίσης γνωστή ως κύστη Baker, είναι ένα οίδημα γεμάτο με υγρό που προκαλεί ένα κομμάτι στο πίσω μέρος του γόνατος, οδηγώντας σε σφίξιμο και περιορισμένη κίνηση. Η κύστη μπορεί να ...
Έγκυος για τις διακοπές: 17 Holi-Yays και Holi-Nays

Έγκυος για τις διακοπές: 17 Holi-Yays και Holi-Nays

...