MedlinePlus Connect: Ứng dụng web

NộI Dung

• Tổng quan về ứng dụng web
• Yêu cầu đối với mã chẩn đoán (Sự cố)
• Các thông số tùy chọn
• Ví dụ về yêu cầu mã vấn đề
• Yêu cầu thông tin thuốc
• Các thông số tùy chọn
• 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
• 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 ứng dụng Web, đáp ứng các yêu cầu dựa trên:

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. Bạn có thể liên kết đến và hiển thị dữ liệu do MedlinePlus Connect cung cấp. Để 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.

Tổng quan về ứng dụng web

API cho ứng dụng Web tuân theo đặc điểm kỹ thuật triển khai dựa trên URL của yêu cầu kiến ​​thức về ngữ cảnh-nhận thức của HL7 (Infobutton). 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 ứng dụng Web là: https://connect.medlineplus.gov/application

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.

Yêu cầu đối với mã chẩn đoán (Sự cố)

MedlinePlus Connect đối sánh mã ICD-10-CM, ICD-9-CM hoặc SNOMED CT với các trang chủ đề sức khỏe, trang di truyền học hoặc các trang của các Viện NIH khác có liên quan. Ví dụ: một bệnh nhân được chẩn đoán với ICD-9-CM mã 493.12, hen suyễn ngoại sinh với đợt cấp, có thể được trình bày một liên kết trong hồ sơ sức khỏe điện tử (EHR) dẫn đến trang MedlinePlus về bệnh hen suyễn.

Liên kết này hiển thị một trang có hộp tìm kiếm trống. Có hai tham số bắt buộc cho bất kỳ truy vấn nào đối với ứng dụng này:

1. 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. 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

Xác định tên / tiêu đề của mã vấn đề. Không gửi mã sẽ dẫn đến một truy vấn đến công cụ tìm kiếm MedlinePlus. Nếu bạn chỉ định mã và tên / tiêu đề của mã, nhưng MedlinePlus Connect không có kết quả, trang phản hồi sẽ hiển thị hộp tìm kiếm MedlinePlus được điền sẵn tên / tiêu đề. mainSearchCriteria.v.dn = Đái tháo đường kèm theo hôn mê loại 1 không kiểm soát được

Xác định xem bạn muốn yêu cầu 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

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/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% 20uncontrolled & informationRecipient.languageCode.c = es

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/application?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

Truy vấn dạng tự do, không có hệ thống mã hoặc mã sự cố, sẽ sử dụng công cụ tìm kiếm MedlinePlus (chỉ bằng tiếng Anh): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

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 phản hồi cho các yêu cầu mã thuốc bằng tiếng Anh hoặc tiếng Tây Ban Nha và sẽ trả về một liên kết đến trang kết quả với các kết quả phù hợp nhất từ ​​thông tin thuốc MedlinePlus.

Đố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 mã NDC hoặc RXCUI hoặc nếu chúng tôi thấy không khớp dựa trên mã, chúng tôi 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; nó không sử dụng chuỗi văn bản. Có thể có câu trả lời bằng tiếng Anh nhưng không có câu trả lời bằng tiếng Tây Ban Nha.

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. Nếu MedlinePlus Connect tìm thấy phản hồi trống cho một yêu cầu thuốc, chương trình sẽ hiển thị hộp tìm kiếm cho trang MedlinePlus. Người dùng có thể gõ tên thuốc và có thể nhận được phản hồi tốt.

Đối với các yêu cầu về thông tin thuốc, URL cơ sở là: https://connect.medlineplus.gov/application

Yêu cầu thông tin thuốc bằng tiếng Anh và tiếng Tây Ban Nha có các yêu cầu khác nhau. Để gửi một yêu cầu, hãy bao gồm các phần thông tin sau:

1. 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

2. 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. 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

Đối với các yêu cầu bằng tiếng Anh, bạn nên xác định tối thiểu 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. Đối với các yêu cầu bằng tiếng Tây Ban Nha, bạn nên xác định hệ thống mã và mã.

Các thông số tùy chọn

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. Tham số này không được sử dụng cho các yêu cầu tiếng Tây Ban Nha.

Xác định xem bạn muốn yêu cầu 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 bản tra cứu mã thuố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

Ví dụ về yêu cầu mã thuốc

Yêu cầu thông tin thuốc của bạn phải giống như 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/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 = 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/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-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 tiếng Anh. Yêu cầu của bạn có thể giống như sau: 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 = 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. MedlinePlus Connect có thể cung cấp phản hồi cho các yêu cầu kiểm tra trong phòng thí nghiệm bằng tiếng Anh hoặc tiếng Tây Ban Nha và sẽ trả về một liên kết đến trang kết quả có kết quả phù hợp nhất từ ​​thông tin kiểm tra phòng thí nghiệm của MedlinePlus.

Đối với các yêu cầu về thông tin kiểm tra trong phòng thí nghiệm, URL cơ sở là: https://connect.medlineplus.gov/application

Đâ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 ứng dụng này:

1. Xác định rằng bạn đang sử dụng hệ thống mã LOINC.
   

   Để sử dụng LOINC:

   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. 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

Xác định tên / tiêu đề 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

Xác định xem bạn muốn yêu cầu 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

Một truy vấn dạng tự do, không có hệ thống mã hoặc mã phòng thí nghiệm, sẽ sử dụng công cụ tìm kiếm MedlinePlus. Cách tiếp cận này hiệu quả hơn với các chẩn đoán (xem thông tin mã vấn đề ở trên) thay vì các chuỗi văn bản kiểm tra trong phòng thí nghiệm. Yêu cầu thông tin kiểm tra phòng thí nghiệm của bạn phải giống như sau.

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/application?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/application?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/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

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