MedlinePlus Connect: Aplikasi Web

Isi
- Ikhtisar Aplikasi Web
- Permintaan Kode Diagnosis (Masalah)
- Parameter Opsional
- Contoh Permintaan Kode Masalah
- Permintaan Informasi Obat
- Parameter Opsional
- Contoh Permintaan Kode Obat
- Permintaan Informasi Uji Lab
- Parameter Opsional
- Contoh Permintaan Tes Lab
- Kebijakan Penggunaan yang Dapat Diterima
- Informasi Lebih Lanjut
MedlinePlus Connect tersedia sebagai aplikasi Web atau layanan Web. Di bawah ini adalah detail teknis untuk mengimplementasikan aplikasi Web, yang merespons permintaan berdasarkan:
Jika Anda memutuskan untuk menggunakan MedlinePlus Connect, daftar ke daftar email untuk mengikuti perkembangan dan bertukar ide dengan kolega Anda. Harap beri tahu kami jika Anda menerapkan MedlinePlus Connect dengan menghubungi kami. Anda dipersilakan untuk menautkan dan menampilkan data yang disediakan oleh MedlinePlus Connect. Untuk informasi lebih lanjut tentang cara menautkan ke konten MedlinePlus di luar layanan ini, silakan lihat pedoman dan instruksi kami tentang menautkan.
Ikhtisar Aplikasi Web
API untuk aplikasi Web sesuai dengan HL7 Context-Aware Knowledge Retrieval (Infobutton) spesifikasi Implementasi Berbasis URL Permintaan Pengetahuan. Struktur permintaan menunjukkan jenis kode yang Anda kirim. Dalam semua kasus, URL dasar untuk aplikasi Web adalah: https://connect.medlineplus.gov/application
MedlinePlus Connect menggunakan koneksi HTTPS. Permintaan HTTP tidak akan diterima dan implementasi yang ada menggunakan HTTP harus diperbarui ke HTTPS.
Permintaan Kode Diagnosis (Masalah)
MedlinePlus Connect mencocokkan kode ICD-10-CM, ICD-9-CM atau SNOMED CT dengan halaman topik kesehatan MedlinePlus terkait, halaman genetika, atau halaman dari NIH Institutes lainnya. Misalnya, pasien yang didiagnosis dengan kode ICD-9-CM 493.12, Asma ekstrinsik dengan eksaserbasi, dapat disajikan tautan dalam catatan kesehatan elektronik (EHR) yang mengarah ke halaman MedlinePlus Asma.
Untuk permintaan berdasarkan masalah, URL dasar aplikasi adalah: https://connect.medlineplus.gov/applicationTautan ini menampilkan halaman dengan kotak pencarian kosong. Ada dua parameter yang diperlukan untuk setiap kueri ke aplikasi ini:
- Identifikasi sistem kode masalah yang akan Anda gunakan.
- Untuk penggunaan ICD-10-CM:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.90
- Untuk penggunaan ICD-9-CM:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.103
- Untuk penggunaan CT SNOMED:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.96
- Identifikasi kode aktual yang Anda coba cari:
mainSearchCriteria.v.c=250.33
Parameter Opsional
Identifikasi nama/judul kode masalah. Mengirim kode tidak akan menghasilkan kueri ke mesin pencari MedlinePlus. Jika Anda menentukan kode dan nama/judul kode, tetapi MedlinePlus Connect tidak memiliki hasil, halaman respons akan menampilkan kotak pencarian MedlinePlus yang telah diisi dengan nama/judul. mainSearchCriteria.v.dn=Diabetes mellitus dengan koma tipe 1 lainnya tidak terkontrol
Identifikasi apakah Anda ingin permintaan dalam bahasa Inggris atau Spanyol. MedlinePlus Connect akan menganggap bahasa Inggris adalah bahasa jika tidak ditentukan.
Jika Anda ingin jawaban untuk pencarian kode masalah dalam bahasa Spanyol, gunakan : informationRecipient.languageCode.c=es
(=sp juga diterima)
Untuk menentukan bahasa Inggris, gunakan yang berikut ini: informationRecipient.languageCode.c=en
Contoh Permintaan Kode Masalah
Permintaan lengkap untuk Diabetes Mellitus dengan koma tipe 1 lain yang tidak terkontrol, kode ICD-9 250.33, untuk pasien berbahasa Spanyol akan memiliki alamat URL berikut: 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
Seorang pasien yang didiagnosis dengan "Pneumonia karena Pseudomonas" menggunakan kode CT SNOMED 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonia%20due%20to%20Pseudomonas%20%28disorder%29&informationRecipient.languageCode.c=en
Kueri bentuk bebas, tanpa sistem kode atau kode masalah, akan menggunakan mesin pencari MedlinePlus (hanya dalam bahasa Inggris): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
Permintaan Informasi Obat
MedlinePlus Connect memberikan kecocokan informasi obat terbaik saat menerima RXCUI. Ini juga memberikan hasil yang baik saat menerima kode NDC. MedlinePlus Connect dapat memberikan tanggapan atas permintaan kode obat dalam bahasa Inggris atau Spanyol dan akan mengembalikan tautan ke halaman hasil dengan kecocokan terbaik dari informasi obat MedlinePlus.
Untuk permintaan informasi pengobatan bahasa Inggris, jika Anda tidak mengirimkan kode NDC atau RXCUI atau jika kami tidak menemukan kecocokan berdasarkan kode tersebut, kami akan menggunakan string teks yang Anda kirim untuk menampilkan kecocokan informasi obat terbaik. Untuk permintaan informasi pengobatan Spanyol, MedlinePlus Connect hanya menanggapi NDC atau RXCUI; itu tidak menggunakan string teks. Dimungkinkan untuk memiliki respons dalam bahasa Inggris tetapi tidak ada respons dalam bahasa Spanyol.
Mungkin ada beberapa tanggapan untuk satu permintaan obat. Mungkin tidak selalu ada kecocokan untuk setiap permintaan. Jika MedlinePlus Connect menemukan respons nol untuk permintaan obat, program akan menampilkan kotak pencarian untuk situs MedlinePlus. Seorang pengguna dapat mengetikkan nama obat dan mungkin mendapatkan respon yang baik.
Untuk permintaan informasi obat, URL dasarnya adalah: https://connect.medlineplus.gov/application
Permintaan informasi obat dalam bahasa Inggris dan Spanyol memiliki persyaratan yang berbeda. Untuk mengirim permintaan, sertakan informasi berikut:
- Identifikasi jenis kode obat yang Anda kirimkan. (Diperlukan untuk bahasa Inggris dan Spanyol)
- Untuk penggunaan RXCUI:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.88
- Untuk penggunaan NDC:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.69
- Identifikasi kode aktual yang Anda coba cari. (Diutamakan untuk Bahasa Inggris, Diperlukan untuk Bahasa Spanyol)
mainSearchCriteria.v.c=637188 - Identifikasi nama obat dengan string teks. (Opsional untuk bahasa Inggris, Tidak digunakan untuk bahasa Spanyol)
mainSearchCriteria.v.dn=Chantix 0.5 MG Oral Tablet
Untuk permintaan bahasa Inggris, Anda harus mengidentifikasi minimal sistem kode dan kode, atau sistem kode dan nama obat. Kirim ketiganya untuk hasil terbaik untuk permintaan bahasa Inggris. Untuk permintaan bahasa Spanyol, Anda harus mengidentifikasi sistem kode dan kodenya.
Parameter Opsional
Saat mengirim permintaan informasi bahasa Inggris, Anda dapat menyertakan parameter opsional dari nama obat. Ini dirinci dalam bagian di atas. Parameter ini tidak digunakan untuk permintaan bahasa Spanyol.
Identifikasi apakah Anda ingin permintaan dalam bahasa Inggris atau Spanyol. MedlinePlus Connect akan menganggap bahasa Inggris adalah bahasa jika tidak ditentukan.
Jika Anda ingin tanggapan terhadap pencarian kode obat dalam bahasa Spanyol, gunakan: informationRecipient.languageCode.c=es (=sp juga diterima)
Untuk menentukan bahasa Inggris, gunakan yang berikut ini: informationRecipient.languageCode.c=en
Contoh Permintaan Kode Obat
Permintaan informasi obat Anda akan terlihat seperti salah satu dari berikut ini.
Untuk meminta informasi oleh RXCUI, permintaan Anda akan terlihat seperti ini: 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=en
Untuk meminta informasi oleh NDC untuk penutur bahasa Spanyol, permintaan Anda akan terlihat seperti ini: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39&informationRecipient.languageCode.c=es
Untuk mengirim string teks tanpa kode obat, Anda harus mengidentifikasi kueri Anda sebagai permintaan tipe NDC sehingga MedlinePlus Connect mengetahui bahwa Anda sedang mencari informasi obat. Ini hanya akan berfungsi untuk bahasa Inggris. Permintaan Anda dapat terlihat seperti ini: 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 =en
Permintaan Informasi Uji Lab
MedlinePlus Connect menyediakan informasi uji laboratorium yang cocok saat menerima permintaan LOINC. MedlinePlus Connect dapat memberikan tanggapan atas permintaan uji lab dalam bahasa Inggris atau Spanyol dan akan mengembalikan tautan ke halaman hasil dengan kecocokan terbaik dari informasi uji lab MedlinePlus.
Untuk permintaan informasi tes lab, URL dasarnya adalah: https://connect.medlineplus.gov/application
Ini adalah dua parameter yang diperlukan untuk kueri uji lab apa pun untuk aplikasi ini:
- Identifikasi bahwa Anda menggunakan sistem kode LOINC.
- Untuk penggunaan LOINC:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.1
- MedlinePlus Connect juga akan menerima:
- mainSearchCriteria.v.cs=2.16.840.1.113883.11.79
- Identifikasi kode aktual yang Anda coba cari.
mainSearchCriteria.v.c=3187-2
Parameter Opsional
Identifikasi nama/judul tes lab. Namun, informasi ini tidak memengaruhi respons. mainSearchCriteria.v.dn=Pengujian Faktor IX
Identifikasi apakah Anda ingin permintaan dalam bahasa Inggris atau Spanyol. MedlinePlus Connect akan menganggap bahasa Inggris adalah bahasa jika tidak ditentukan.
Jika Anda ingin jawaban untuk pencarian kode masalah dalam bahasa Spanyol, gunakan: informationRecipient.languageCode.c=es (=sp juga diterima)
Untuk menentukan bahasa Inggris, gunakan yang berikut ini: informationRecipient.languageCode.c=en
Kueri bentuk bebas, tanpa sistem kode atau kode lab, akan menggunakan mesin telusur MedlinePlus. Pendekatan ini lebih efektif dengan diagnosis (lihat informasi kode masalah di atas) daripada string teks uji lab. Permintaan informasi uji lab Anda akan terlihat seperti salah satu dari berikut ini.
Contoh Permintaan Tes Lab
Untuk meminta informasi bagi penutur bahasa Inggris, permintaan Anda mungkin terlihat seperti berikut ini: 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=en https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =en
Untuk meminta informasi bagi penutur bahasa Spanyol, permintaan Anda mungkin terlihat seperti berikut ini: 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
Kebijakan Penggunaan yang Dapat Diterima
Untuk menghindari kelebihan server MedlinePlus, NLM mengharuskan pengguna MedlinePlus Connect mengirim tidak lebih dari 100 permintaan per menit per alamat IP. Permintaan yang melebihi batas ini tidak akan dilayani, dan layanan tidak akan dipulihkan selama 300 detik atau hingga tingkat permintaan turun di bawah batas, mana saja yang lebih lambat. Untuk membatasi jumlah permintaan yang Anda kirim ke Connect, NLM merekomendasikan hasil caching untuk jangka waktu 12-24 jam.
Kebijakan ini diterapkan untuk memastikan bahwa layanan tetap tersedia dan dapat diakses oleh semua pengguna. Jika Anda memiliki kasus penggunaan khusus yang mengharuskan Anda mengirim sejumlah besar permintaan ke MedlinePlus Connect, dan dengan demikian melebihi batas tingkat permintaan yang diuraikan dalam kebijakan ini, silakan hubungi kami. Staf NLM akan mengevaluasi permintaan Anda dan menentukan apakah pengecualian dapat diberikan. Harap tinjau juga dokumentasi file MedlinePlus XML. File XML ini berisi catatan topik kesehatan lengkap dan dapat berfungsi sebagai metode alternatif untuk mengakses data MedlinePlus.