MedlinePlus Connect: Dịch vụ Web
NộI Dung
- Tổng quan về dịch vụ web
- Tham số đầu ra
- Yêu cầu đối với mã chẩn đoán (Sự cố)
- Các thông số tùy chọn
- Mô tả các Phần tử nguyên tử đã chọn (hoặc các đối tượng JSON) trong Phản hồi yêu cầu mã sự cố
- Ví dụ về yêu cầu mã vấn đề
- Các dịch vụ và tệp liên quan
- Yêu cầu thông tin thuốc
- Các thông số tùy chọn
- Mô tả các Phần tử nguyên tử được Chọn (hoặc các đối tượng JSON) trong Phản hồi Yêu cầu Thuốc
- Ví dụ về yêu cầu mã thuốc
- Yêu cầu thông tin kiểm tra phòng thí nghiệm
- Các thông số tùy chọn
- Mô tả các Phần tử nguyên tử đã chọn (hoặc các đối tượng JSON) trong Phản hồi các Yêu cầu Kiểm tra Phòng thí nghiệm
- Ví dụ về Yêu cầu Kiểm tra Phòng thí nghiệm
- Sự cho phép của chính trị
- Thêm thông tin
MedlinePlus Connect có sẵn dưới dạng ứng dụng Web hoặc dịch vụ Web. Dưới đây là các chi tiết kỹ thuật để triển khai dịch vụ Web, đáp ứng các yêu cầu dựa trên:
Bạn có thể liên kết đến và hiển thị dữ liệu do MedlinePlus Connect trả về. Bạn không được sao chép các trang MedlinePlus vào trang web của mình. Nếu bạn sử dụng dữ liệu từ Dịch vụ Web của MedlinePlus Connect, vui lòng cho biết rằng thông tin đến từ MedlinePlus.gov nhưng không sử dụng biểu trưng MedlinePlus hoặc ngụ ý rằng MedlinePlus xác nhận sản phẩm cụ thể của bạn. Vui lòng xem trang API của NLM để được hướng dẫn thêm. Để biết thêm thông tin về cách liên kết đến nội dung MedlinePlus bên ngoài dịch vụ này, vui lòng xem nguyên tắc và hướng dẫn của chúng tôi về cách liên kết.
Nếu bạn quyết định sử dụng MedlinePlus Connect, hãy đăng ký danh sách email để cập nhật sự phát triển và trao đổi ý kiến với đồng nghiệp của bạn. Vui lòng cho chúng tôi biết nếu bạn triển khai MedlinePlus Connect bằng cách liên hệ với chúng tôi.
Tổng quan về dịch vụ web
Các tham số cho các yêu cầu dịch vụ Web tuân theo Hướng dẫn triển khai dựa trên URL của yêu cầu nhận thức về ngữ cảnh của HL7 (Infobutton). Phản hồi dựa trên REST tuân theo Hướng dẫn triển khai kiến trúc hướng dịch vụ theo ngữ cảnh-nhận thức của HL7 (Infobutton). Đầu ra của yêu cầu có thể là XML ở định dạng nguồn cấp dữ liệu Atom, JSON hoặc JSONP.
Cấu trúc của yêu cầu cho biết loại mã bạn đang gửi. Trong mọi trường hợp, URL cơ sở cho dịch vụ Web là: https://connect.medlineplus.gov/service
MedlinePlus Connect sử dụng kết nối HTTPS. Yêu cầu HTTP sẽ không được chấp nhận và các triển khai hiện có sử dụng HTTP phải cập nhật lên HTTPS.
Tham số đầu ra
Các thông số này là tùy chọn. Nếu bạn bỏ qua chúng, phản hồi mặc định là thông tin tiếng Anh ở định dạng XML.
Ngôn ngữ
Xác định xem bạn muốn phản hồi bằng tiếng Anh hay tiếng Tây Ban Nha. MedlinePlus Connect sẽ coi là ngôn ngữ tiếng Anh nếu nó không được chỉ định.
Nếu bạn muốn phản hồi cho tra cứu mã sự cố bằng tiếng Tây Ban Nha, hãy sử dụng: informationRecipient.languageCode.c = es
(= sp cũng được chấp nhận)
Để chỉ định tiếng Anh, hãy sử dụng như sau: informationRecipient.languageCode.c = vi
định dạng
Xác định xem bạn muốn định dạng phản hồi là XML, JSON hay JSONP. XML là mặc định.
- Để yêu cầu JSON, hãy sử dụng:
- KnowledgeResponseType = application / json
- Đối với JSONP, hãy sử dụng:
- KnowledgeResponseType = application / javascript & callback = CallbackFunction trong đó CallbackFunction là tên mà bạn đặt cho hàm gọi lại.
- Đối với phản hồi bằng XML, hãy sử dụng:
- knowledgeResponseType = text / xml hoặc bỏ tham số knowledgeResponseType ra khỏi yêu cầu.
Yêu cầu đối với mã chẩn đoán (Sự cố)
Đối với mã sự cố, MedlinePlus Connect sẽ trả về các liên kết và thông tin từ các trang chủ đề sức khỏe của MedlinePlus, trang di truyền học hoặc các trang từ các Viện NIH khác.
MedlinePlus Connect sẽ trả về như sau:
Có thể không phải lúc nào cũng có sự trùng khớp cho mỗi mã. Trong những trường hợp đó, MedlinePlus Connect sẽ trả về phản hồi rỗng.
URL cơ sở của dịch vụ là: https://connect.medlineplus.gov/service
Có hai tham số bắt buộc cho bất kỳ truy vấn nào đối với dịch vụ này:
- Hệ thống mã
Xác định hệ thống mã vấn đề mà bạn sẽ sử dụng.- Để sử dụng ICD-10-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- Để sử dụng ICD-9-CM:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- Để sử dụng SNOMED CT:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Mã
Xác định mã thực mà bạn đang cố gắng tra cứu:
mainSearchCriteria.v.c = 250,33
Các thông số tùy chọn
Tiêu đề mã
Bạn cũng có thể xác định tên / tiêu đề của mã sự cố. Tuy nhiên, thông tin này không ảnh hưởng đến phản hồi (không giống như ứng dụng Web MedlinePlus Connect nơi thông tin tên / chức danh có thể được sử dụng). mainSearchCriteria.v.dn = Đái tháo đường kèm theo hôn mê loại 1 khác không kiểm soát được Xem phần trên về Thông số đầu ra để biết chi tiết về ngôn ngữ và định dạng đầu ra.
Mô tả các Phần tử nguyên tử đã chọn (hoặc các đối tượng JSON) trong Phản hồi yêu cầu mã sự cố
| Thành phần | Nút lớp | Sự miêu tả |
|---|---|---|
| tiêu đề | Tiêu đề của trang chủ đề sức khỏe MedlinePlus phù hợp hoặc trang GHR | |
| liên kết | URL cho trang chủ đề sức khỏe MedlinePlus phù hợp hoặc trang GHR | |
| tóm lược | Bản tóm tắt đầy đủ cho chủ đề sức khỏe. Điều này bao gồm các liên kết được nhúng tới các chủ đề sức khỏe có liên quan khác và tất cả các định dạng, bao gồm dấu đầu dòng và khoảng cách đoạn văn. Bản tóm tắt bằng HTML. Đối với các trang GHR, phần đầu tiên của trang đầy đủ được cung cấp. | |
| tóm lược | Từ đồng nghĩa với chủ đề. Chúng được gọi là "Còn được gọi là" trên trang chủ đề sức khỏe. Không phải tất cả các chủ đề đều có thuật ngữ "Còn được gọi là". | |
| tóm lược | Xác nhận ghi nhận tác giả cho văn bản tóm tắt, nếu phần lớn nội dung tóm tắt là từ một cơ quan liên bang khác. Không phải tất cả các bản tóm tắt đều có ghi công. Văn bản chưa được phân bổ là văn bản gốc của MedlinePlus. | |
| tóm lược | Các liên kết được chọn liên kết với chủ đề. Điều này bao gồm tên trang, URL và tổ chức được liên kết (nếu có). Các liên kết được định dạng trong một danh sách có dấu đầu dòng. Không phải tất cả các chủ đề đều có các liên kết này. Số lượng liên kết có thể từ 0 đến hàng chục. |
Ví dụ về yêu cầu mã vấn đề
Một yêu cầu hoàn chỉnh cho bệnh Đái tháo đường kèm theo hôn mê loại 1 không kiểm soát khác, mã ICD-9 250.33, dành cho bệnh nhân nói tiếng Tây Ban Nha sẽ có địa chỉ URL sau: 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
Một bệnh nhân có cùng chẩn đoán nhưng định dạng được yêu cầu là JSON và ngôn ngữ là tiếng Anh: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json
Một bệnh nhân được chẩn đoán "Viêm phổi do Pseudomonas" bằng SNOMED CT mã 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Viêm phổi% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = vi
Một bệnh nhân có cùng chẩn đoán nhưng định dạng được yêu cầu là 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
Các dịch vụ và tệp liên quan
Để nhận các chủ đề về sức khỏe của MedlinePlus theo yêu cầu văn bản, trái ngược với mã sự cố, hãy điều tra dịch vụ Web của MedlinePlus. Ngoài ra, nếu bạn cần bộ đầy đủ các chủ đề sức khỏe của MedlinePlus ở định dạng XML, hãy xem trang tệp XML của chúng tôi.
Yêu cầu thông tin thuốc
MedlinePlus Connect cung cấp thông tin thuốc phù hợp nhất khi nhận RXCUI. Nó cũng cung cấp kết quả tốt khi nhận được mã NDC. MedlinePlus Connect có thể cung cấp câu trả lời bằng tiếng Anh hoặc tiếng Tây Ban Nha.
Đối với các yêu cầu về thông tin thuốc bằng tiếng Anh, nếu bạn không gửi NDC hoặc RXCUI hoặc nếu chúng tôi nhận thấy không khớp dựa trên mã, ứng dụng sẽ sử dụng chuỗi văn bản mà bạn gửi để hiển thị thông tin thuốc phù hợp nhất. Đối với các yêu cầu về thông tin thuốc Tây Ban Nha, MedlinePlus Connect chỉ trả lời NDC hoặc RXCUI và không sử dụng chuỗi văn bản. Có thể có phản hồi bằng tiếng Anh nhưng không có phản hồi bằng tiếng Tây Ban Nha.
Dịch vụ Web của MedlinePlus Connect sẽ trả về như sau:
Có thể có nhiều phản hồi cho một yêu cầu thuốc. Có thể không phải lúc nào cũng có kết quả phù hợp cho mỗi yêu cầu. Trong những trường hợp đó, MedlinePlus Connect sẽ trả về phản hồi rỗng.
Đối với các yêu cầu về thông tin thuốc, URL cơ sở là: https://connect.medlineplus.gov/service
Để gửi một yêu cầu, hãy bao gồm các phần thông tin sau:
- Hệ thống mã
Xác định loại mã thuốc bạn đang gửi. (Bắt buộc đối với tiếng Anh và tiếng Tây Ban Nha)- Để sử dụng RXCUI:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- Để sử dụng NDC:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Mã
Xác định mã thực mà bạn đang cố gắng tra cứu. (Ưu tiên cho tiếng Anh, bắt buộc cho tiếng Tây Ban Nha)
mainSearchCriteria.v.c = 637188 - Tên thuốc
Xác định tên thuốc bằng một chuỗi văn bản. (Tùy chọn cho tiếng Anh, không sử dụng cho tiếng Tây Ban Nha)
mainSearchCriteria.v.dn = Viên uống Chantix 0,5 MG
Các thông số tùy chọn
Tiêu đề mãKhi gửi yêu cầu cung cấp thông tin bằng tiếng Anh, bạn có thể bao gồm thông số tùy chọn của tên thuốc. Điều này được trình bày chi tiết trong phần trên. mainSearchCriteria.v.dn = Viên uống Chantix 0,5 MG
Xem phần trên về Tham số đầu ra để biết chi tiết về ngôn ngữ và định dạng đầu ra.
Mô tả các Phần tử nguyên tử được Chọn (hoặc các đối tượng JSON) trong Phản hồi Yêu cầu Thuốc
| Thành phần | Sự miêu tả |
|---|---|
| tiêu đề | Tiêu đề cho trang thuốc MedlinePlus phù hợp |
| liên kết | URL cho trang thuốc MedlinePlus phù hợp |
| tác giả | Phân bổ nguồn cho thông tin thuốc |
Ví dụ về yêu cầu mã thuốc
Yêu cầu thông tin về thuốc của bạn phải giống như một trong những yêu cầu sau.
Để yêu cầu thông tin bằng RXCUI, yêu cầu của bạn sẽ giống như sau: 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 = vi
Để yêu cầu thông tin từ NDC cho một người nói tiếng Tây Ban Nha, yêu cầu của bạn sẽ giống như sau: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es
Để gửi một chuỗi văn bản không có mã thuốc, bạn phải xác định truy vấn của mình là một yêu cầu kiểu NDC để MedlinePlus Connect biết bạn đang tìm kiếm thông tin về thuốc. Điều này sẽ chỉ hoạt động cho các yêu cầu bằng tiếng Anh. Yêu cầu của bạn có thể giống như sau: 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 = vi
Yêu cầu thông tin kiểm tra phòng thí nghiệm
MedlinePlus Connect cung cấp các kết quả phù hợp với thông tin xét nghiệm trong phòng thí nghiệm khi nhận được yêu cầu LOINC. Dịch vụ có thể cung cấp phản hồi bằng tiếng Anh hoặc tiếng Tây Ban Nha.
Dịch vụ Web của MedlinePlus Connect sẽ trả về như sau:
Có thể không phải lúc nào cũng có sự trùng khớp cho mỗi mã. Trong những trường hợp đó, MedlinePlus Connect sẽ trả về phản hồi rỗng.
URL cơ sở của dịch vụ là: https://connect.medlineplus.gov/service
Đây là hai tham số bắt buộc cho bất kỳ truy vấn kiểm tra phòng thí nghiệm nào đối với dịch vụ này:
- Hệ thống mã
- Xác định rằng bạn đang sử dụng hệ thống mã LOINC. Sử dụng:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect cũng sẽ chấp nhận:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Mã
xác định mã thực mà bạn đang cố gắng tra cứu:
mainSearchCriteria.v.c = 3187-2
Các thông số tùy chọn
Tiêu đề mãBạn cũng có thể xác định tên của bài kiểm tra trong phòng thí nghiệm. Tuy nhiên, thông tin này không ảnh hưởng đến phản hồi. mainSearchCriteria.v.dn = Xét nghiệm Yếu tố IX
Xem phần trên về Tham số đầu ra để biết chi tiết về ngôn ngữ và định dạng đầu ra.
Mô tả các Phần tử nguyên tử đã chọn (hoặc các đối tượng JSON) trong Phản hồi các Yêu cầu Kiểm tra Phòng thí nghiệm
| Thành phần | Sự miêu tả |
|---|---|
| tiêu đề | Tiêu đề của trang kiểm tra phòng thí nghiệm MedlinePlus phù hợp |
| liên kết | URL cho trang kiểm tra phòng thí nghiệm MedlinePlus phù hợp |
| tóm lược | Đoạn mã từ nội dung trang |
| tác giả | Ghi nhận nguồn cho nội dung thử nghiệm trong phòng thí nghiệm |
Ví dụ về Yêu cầu Kiểm tra Phòng thí nghiệm
Để yêu cầu thông tin cho một người nói tiếng Anh, yêu cầu của bạn có thể giống như sau: 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 = vi https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = vi
Để yêu cầu thông tin cho người nói tiếng Tây Ban Nha, yêu cầu của bạn có thể giống như sau: 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
Sự cho phép của chính trị
Để tránh làm quá tải các máy chủ của MedlinePlus, NLM yêu cầu người dùng MedlinePlus Connect gửi không quá 100 yêu cầu mỗi phút cho mỗi địa chỉ IP. Các yêu cầu vượt quá giới hạn này sẽ không được phục vụ và dịch vụ sẽ không được khôi phục trong 300 giây hoặc cho đến khi tỷ lệ yêu cầu giảm xuống dưới giới hạn, tùy điều kiện nào đến sau. Để giới hạn số lượng yêu cầu mà bạn gửi tới Connect, NLM đề xuất kết quả vào bộ nhớ đệm trong khoảng thời gian 12-24 giờ.
Chính sách này được áp dụng để đảm bảo rằng dịch vụ vẫn có sẵn và có thể truy cập được cho tất cả người dùng. Nếu bạn có một trường hợp sử dụng cụ thể yêu cầu bạn gửi một số lượng lớn yêu cầu đến MedlinePlus Connect và do đó vượt quá giới hạn tỷ lệ yêu cầu được nêu trong chính sách này, vui lòng liên hệ với chúng tôi. Nhân viên NLM sẽ đánh giá yêu cầu của bạn và xác định xem liệu một ngoại lệ có thể được chấp nhận hay không. Vui lòng xem lại tài liệu tệp XML của MedlinePlus. Các tệp XML này chứa các bản ghi chủ đề sức khỏe hoàn chỉnh và có thể dùng như một phương pháp thay thế để truy cập dữ liệu MedlinePlus.
Thêm thông tin
Bài ViếT CủA CổNg Thông Tin
Tại sao tôi bị khó tiêu?
