MedlinePlus Connect: Υπηρεσία Ιστού
Περιεχόμενο
- Επισκόπηση υπηρεσίας Web
- Παράμετροι εξόδου
- Αιτήματα για κωδικούς διάγνωσης (Πρόβλημα)
- Προαιρετικές παράμετροι
- Περιγραφή επιλεγμένων στοιχείων Atom (ή αντικειμένων JSON) στην απάντηση σε αιτήματα κωδικού προβλήματος
- Παραδείγματα αιτημάτων για κωδικούς προβλήματος
- Σχετικές υπηρεσίες και αρχεία
- Αιτήματα για πληροφορίες σχετικά με τα ναρκωτικά
- Προαιρετικές παράμετροι
- Περιγραφή επιλεγμένων στοιχείων Atom (ή αντικειμένων JSON) στην απόκριση σε αιτήσεις φαρμάκων
- Παραδείγματα αιτημάτων για κωδικούς ναρκωτικών
- Αιτήματα για πληροφορίες εργαστηριακών δοκιμών
- Προαιρετικές παράμετροι
- Περιγραφή επιλεγμένων στοιχείων Atom (ή αντικειμένων JSON) στην απόκριση σε αιτήματα δοκιμής εργαστηρίου
- Παραδείγματα αιτημάτων για εργαστηριακές δοκιμές
- Πολιτική αποδεκτής χρήσης
- Περισσότερες πληροφορίες
Το 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
Υπάρχουν δύο απαιτούμενες παράμετροι για οποιοδήποτε ερώτημα σε αυτήν την υπηρεσία:
- Σύστημα κώδικα
Προσδιορίστε το σύστημα κωδικών προβλημάτων που θα χρησιμοποιείτε.- Για χρήση 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
- Κώδικας
Προσδιορίστε τον πραγματικό κωδικό που προσπαθείτε να αναζητήσετε:
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
Για να στείλετε ένα αίτημα, συμπεριλάβετε αυτά τα στοιχεία:
- Σύστημα κώδικα
Προσδιορίστε τον τύπο του κωδικού φαρμάκου που στέλνετε. (Απαιτείται για Αγγλικά και Ισπανικά)- Για χρήση RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Για χρήση NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Κώδικας
Προσδιορίστε τον πραγματικό κωδικό που προσπαθείτε να αναζητήσετε. (Προτιμάται για Αγγλικά, Απαιτείται για Ισπανικά)
mainSearchCriteria.v.c = 637188 - Όνομα φαρμάκου
Προσδιορίστε το όνομα του φαρμάκου με μια συμβολοσειρά κειμένου. (Προαιρετικό για Αγγλικά, Δεν χρησιμοποιείται για Ισπανικά)
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
Αυτές είναι δύο απαιτούμενες παράμετροι για οποιοδήποτε ερώτημα εργαστηριακής δοκιμής σε αυτήν την υπηρεσία:
- Σύστημα κώδικα
- Προσδιορίστε ότι χρησιμοποιείτε το σύστημα κώδικα LOINC. Χρήση:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- Το MedlinePlus Connect δέχεται επίσης:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Κώδικας
προσδιορίστε τον πραγματικό κωδικό που προσπαθείτε να αναζητήσετε:
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.