Tác Giả: Eric Farmer
Ngày Sáng TạO: 4 Hành Khúc 2021
CậP NhậT Ngày Tháng: 1 Tháng BảY 2024
Anonim
MedlinePlus
Băng Hình: MedlinePlus

NộI Dung

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:

  1. 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
  2. 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ầnNút lớpSự 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ượcTừ đồ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ượcXá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ượcCá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:

  1. 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
    MedlinePlus Connect cũng có thể chấp nhận một chuỗi văn bản cho các yêu cầu thông tin thuốc bằng tiếng Anh, nhưng bạn phải cho biết bạn đang tìm kiếm thông tin thuốc bằng cách bao gồm một trong hai hệ thống mã được liệt kê ở trên.
  2. 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
  3. 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
Tối thiểu bạn nên xác định hệ thống mã và mã, hoặc hệ thống mã và tên thuốc. Gửi cả ba để có kết quả tốt nhất cho các yêu cầu bằng tiếng Anh. Gửi hệ thống mã và mã cho các yêu cầu tiếng Tây Ban Nha.

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ầnSự miêu tả
tiêu đềTiêu đề cho trang thuốc MedlinePlus phù hợp
liên kếtURL 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:

  1. 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
  2. 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ầnSự 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ếtURL 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

Phổ BiếN

Phiên bản Cephalic bên ngoài là gì và nó có an toàn không?
SứC KhỏE

Phiên bản Cephalic bên ngoài là gì và nó có an toàn không?

Một phiên bản cephalic bên ngoài là một thủ tục được ử dụng để giúp biến em bé trong bụng trước khi inh. Trong uốt quá trình, nhà cung cấp dịch vụ chăm ...
Giãn tĩnh mạch
SứC KhỏE

Giãn tĩnh mạch

Giãn tĩnh mạch là một thủ tục phẫu thuật loại bỏ chứng giãn tĩnh mạch từ chân hoặc đùi. Giãn tĩnh mạch là các tĩnh mạch ưng và xoắn mà bạn có thể...