MedlinePlus Connect: Aplikasi Web

Kandungan

• Gambaran Keseluruhan Aplikasi Web
• Permintaan untuk Kod Diagnosis (Masalah)
• Parameter Pilihan
• Contoh Permintaan untuk Kod Masalah
• Permintaan untuk Maklumat Dadah
• Parameter Pilihan
• Contoh Permintaan untuk Kod Dadah
• Permintaan untuk Maklumat Ujian Makmal
• Parameter Pilihan
• Contoh Permintaan untuk Ujian Makmal
• Dasar Penggunaan yang Boleh Diterima
• Maklumat lanjut

MedlinePlus Connect boleh didapati sebagai aplikasi Web atau perkhidmatan Web. Berikut adalah butiran teknikal untuk melaksanakan aplikasi Web, yang menjawab permintaan berdasarkan:

Sekiranya anda memutuskan untuk menggunakan MedlinePlus Connect, daftarlah ke senarai e-mel untuk mengikuti perkembangan dan bertukar idea dengan rakan sekerja anda. Beritahu kami jika anda melaksanakan MedlinePlus Connect dengan menghubungi kami. Anda dipersilakan untuk memautkan dan memaparkan data yang diberikan oleh MedlinePlus Connect. Untuk maklumat lebih lanjut mengenai cara membuat pautan ke kandungan MedlinePlus di luar perkhidmatan ini, sila lihat garis panduan dan arahan kami mengenai pautan.

Gambaran Keseluruhan Aplikasi Web

API untuk aplikasi Web sesuai dengan spesifikasi Pelaksanaan Berbasis URL Permintaan Pengetahuan Pengambilan Pengetahuan (Infobutton) HL7. Struktur permintaan menunjukkan jenis kod yang anda hantar. Dalam semua keadaan, URL asas untuk aplikasi Web adalah: https://connect.medlineplus.gov/application

MedlinePlus Connect menggunakan sambungan HTTPS. Permintaan HTTP tidak akan diterima dan implementasi yang ada menggunakan HTTP harus dikemas kini ke HTTPS.

Permintaan untuk Kod Diagnosis (Masalah)

MedlinePlus Connect memadankan kod CT ICD-10-CM, ICD-9-CM atau SNOMED dengan halaman topik kesihatan, halaman genetik, atau halaman dari Institut NIH yang lain. Sebagai contoh, seorang pesakit yang didiagnosis dengan kod ICD-9-CM 493.12, asma ekstrinsik dengan eksaserbasi, dapat ditunjukkan pautan dalam rekod kesihatan elektronik (EHR) yang mengarah ke halaman MedlinePlus Asthma.

Pautan ini memaparkan halaman dengan kotak carian kosong. Terdapat dua parameter yang diperlukan untuk sebarang pertanyaan untuk aplikasi ini:

1. Kenal pasti sistem kod 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 SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kenal pasti kod sebenar yang anda cuba cari:
   mainSearchCriteria.v.c = 250.33

Parameter Pilihan

Kenalpasti nama / tajuk kod masalah. Menghantar kod tidak akan menghasilkan pertanyaan ke mesin carian MedlinePlus. Sekiranya anda menentukan kod dan nama / tajuk kod, tetapi MedlinePlus Connect tidak mempunyai hasil, halaman respons akan memaparkan kotak carian MedlinePlus yang diisi dengan nama / tajuk. mainSearchCriteria.v.dn = Diabetes mellitus dengan koma jenis 1 yang lain tidak terkawal

Kenal pasti jika anda mahukan permintaan tersebut dalam Bahasa Inggeris atau Sepanyol. MedlinePlus Connect akan menganggap bahasa Inggeris adalah bahasa jika tidak dinyatakan.

Sekiranya anda menginginkan jawapan terhadap kod masalah dalam bahasa Sepanyol, gunakan: informationRecipient.languageCode.c = es
(= sp juga diterima)

Untuk menentukan bahasa Inggeris, gunakan yang berikut: informationRecipient.languageCode.c = en

Contoh Permintaan untuk Kod Masalah

Permintaan lengkap untuk Diabetes Mellitus dengan kod jenis 1 koma lain yang tidak terkawal, kod ICD-9 250.33, untuk pesakit berbahasa Sepanyol akan mempunyai 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% 20dengan% 20other% 20coma% 20type% 201% 20uncontrolled & informationRecipient.languageCode.c = es

Seorang pesakit yang didiagnosis dengan "Pneumonia akibat Pseudomonas" menggunakan kod CT SNOMED 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.vain Pneumonia% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = en

Pertanyaan bentuk bebas, tanpa sistem kod atau kod masalah, akan menggunakan mesin carian MedlinePlus (hanya bahasa Inggeris): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

Permintaan untuk Maklumat Dadah

MedlinePlus Connect memberikan padanan maklumat ubat terbaik ketika menerima RXCUI. Ia juga memberikan hasil yang baik ketika menerima kod NDC. MedlinePlus Connect dapat memberikan respons terhadap permintaan kod ubat dalam bahasa Inggeris atau Sepanyol dan akan mengembalikan pautan ke halaman hasil dengan padanan terbaik dari maklumat ubat MedlinePlus.

Untuk permintaan maklumat ubat bahasa Inggeris, jika anda tidak menghantar kod NDC atau RXCUI atau jika kami tidak menemui padanan berdasarkan kod tersebut, kami akan menggunakan rentetan teks yang anda kirim untuk memaparkan padanan maklumat ubat terbaik. Untuk permintaan maklumat ubat Sepanyol, MedlinePlus Connect hanya bertindak balas terhadap NDC atau RXCUI; ia tidak menggunakan rentetan teks. Mungkin ada jawapan dalam bahasa Inggeris tetapi tidak ada respons dalam bahasa Sepanyol.

Mungkin ada banyak tindak balas terhadap satu permintaan ubat. Mungkin tidak selalu ada kecocokan untuk setiap permintaan. Sekiranya MedlinePlus Connect menemui jawapan kosong untuk permintaan ubat, program akan memaparkan kotak carian untuk laman MedlinePlus. Pengguna boleh memasukkan nama ubat dan mendapat sambutan yang baik.

Untuk permintaan maklumat dadah, URL asas adalah: https://connect.medlineplus.gov/application

Permintaan untuk maklumat ubat Inggeris dan Sepanyol mempunyai keperluan yang berbeza. Untuk menghantar permintaan, sertakan maklumat ini:

1. Kenal pasti jenis kod ubat yang anda hantar. (Diperlukan untuk Bahasa Inggeris dan Sepanyol)
   

   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

2. Kenal pasti kod sebenar yang anda cari. (Disukai untuk Bahasa Inggeris, Wajib untuk Bahasa Sepanyol)
   mainSearchCriteria.v.c = 637188
3. Kenal pasti nama ubat dengan rentetan teks. (Pilihan untuk Bahasa Inggeris, Tidak digunakan untuk Bahasa Sepanyol)
   mainSearchCriteria.v.dn = Tablet Lisan Chantix 0.5 MG

Untuk permintaan Bahasa Inggeris, anda harus mengenal pasti sekurang-kurangnya sistem kod dan kod, atau sistem kod dan nama ubat. Hantarkan ketiga-tiganya untuk hasil terbaik untuk permintaan Bahasa Inggeris. Untuk permintaan Sepanyol, anda harus mengenal pasti sistem kod dan kodnya.

Parameter Pilihan

Semasa menghantar permintaan untuk maklumat bahasa Inggeris, anda mungkin memasukkan parameter pilihan nama ubat. Ini diperincikan di bahagian di atas. Parameter ini tidak digunakan untuk permintaan Sepanyol.

Kenal pasti jika anda mahukan permintaan tersebut dalam Bahasa Inggeris atau Sepanyol. MedlinePlus Connect akan menganggap bahasa Inggeris adalah bahasa jika tidak dinyatakan.

Sekiranya anda ingin jawapan untuk carian kod ubat menggunakan bahasa Sepanyol, gunakan: informationRecipient.languageCode.c = es (= sp juga diterima)

Untuk menentukan bahasa Inggeris, gunakan yang berikut: informationRecipient.languageCode.c = en

Contoh Permintaan untuk Kod Dadah

Permintaan maklumat ubat anda mestilah seperti berikut.

Untuk meminta maklumat oleh RXCUI, permintaan anda akan kelihatan 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 & maklumatRecipient.languageCode.c = en

Untuk meminta maklumat oleh NDC untuk penutur bahasa Sepanyol, permintaan anda akan kelihatan 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 menghantar rentetan teks tanpa kod ubat, anda mesti mengenal pasti pertanyaan anda sebagai permintaan jenis NDC sehingga MedlinePlus Connect mengetahui bahawa anda mencari maklumat ubat. Ini akan berfungsi untuk Bahasa Inggeris sahaja. Permintaan anda kelihatan 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. = en

Permintaan untuk Maklumat Ujian Makmal

MedlinePlus Connect memberikan padanan dengan maklumat ujian makmal semasa menerima permintaan LOINC. MedlinePlus Connect dapat memberikan respons terhadap permintaan ujian makmal dalam bahasa Inggeris atau Sepanyol dan akan mengembalikan pautan ke halaman hasil dengan padanan terbaik dari maklumat ujian makmal MedlinePlus.

Untuk permintaan maklumat ujian makmal, URL asasnya adalah: https://connect.medlineplus.gov/application

Ini adalah dua parameter yang diperlukan untuk sebarang pertanyaan ujian makmal untuk aplikasi ini:

1. Kenal pasti bahawa anda menggunakan sistem kod LOINC.
   

   Untuk kegunaan 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

2. Kenal pasti kod sebenar yang anda cari.
   mainSearchCriteria.v.c = 3187-2

Parameter Pilihan

Kenalpasti nama / tajuk ujian makmal. Walau bagaimanapun, maklumat ini tidak mempengaruhi tindak balas. mainSearchCriteria.v.dn = Ujian faktor IX

Kenal pasti jika anda mahukan permintaan tersebut dalam Bahasa Inggeris atau Sepanyol. MedlinePlus Connect akan menganggap bahasa Inggeris adalah bahasa jika tidak dinyatakan.

Sekiranya anda menginginkan jawapan terhadap kod masalah dalam bahasa Sepanyol, gunakan: informationRecipient.languageCode.c = es (= sp juga diterima)

Untuk menentukan bahasa Inggeris, gunakan yang berikut: informationRecipient.languageCode.c = en

Pertanyaan bentuk bebas, tanpa sistem kod atau kod makmal, akan menggunakan mesin carian MedlinePlus. Pendekatan ini lebih berkesan dengan diagnosis (lihat maklumat kod masalah di atas) dan bukannya rentetan teks ujian makmal. Permintaan maklumat ujian makmal anda akan kelihatan seperti berikut.

Contoh Permintaan untuk Ujian Makmal

Untuk meminta maklumat penutur bahasa Inggeris, permintaan anda mungkin seperti salah satu daripada yang berikut: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 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&informationRecipientl. = en

Untuk meminta maklumat penutur bahasa Sepanyol, permintaan anda mungkin seperti salah satu daripada yang berikut: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 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&informationRecipientl. = es

Dasar Penggunaan yang Boleh Diterima

Untuk mengelakkan pembebanan pelayan MedlinePlus yang berlebihan, NLM menghendaki pengguna MedlinePlus Connect menghantar tidak lebih dari 100 permintaan per minit setiap alamat IP. Permintaan yang melebihi had ini tidak akan dilayan, dan perkhidmatan tidak akan dipulihkan selama 300 saat atau sehingga kadar permintaan jatuh di bawah had, mana yang datang kemudian. Untuk mengehadkan jumlah permintaan yang anda kirim ke Connect, NLM mengesyorkan hasil cache untuk jangka masa 12-24 jam.

Dasar ini dilaksanakan untuk memastikan bahawa perkhidmatan tetap tersedia dan dapat diakses oleh semua pengguna. Sekiranya anda mempunyai kes penggunaan tertentu yang mengharuskan anda mengirim sejumlah besar permintaan ke MedlinePlus Connect, dan dengan demikian melampaui had kadar permintaan yang dinyatakan dalam polisi ini, sila hubungi kami. Kakitangan NLM akan menilai permintaan anda dan menentukan apakah pengecualian dapat diberikan. Tinjau juga dokumentasi fail MedlinePlus XML. Fail XML ini mengandungi catatan topik kesihatan yang lengkap dan dapat berfungsi sebagai kaedah alternatif untuk mengakses data MedlinePlus.

Maklumat lanjut