MedlinePlus Connect: Perkhidmatan Web

Kandungan

• Gambaran Keseluruhan Perkhidmatan Web
• Parameter Keluaran
• Permintaan untuk Kod Diagnosis (Masalah)
• Parameter Pilihan
• Penerangan tentang Elemen Atom Terpilih (atau objek JSON) dalam Menanggapi Permintaan Kod Masalah
• Contoh Permintaan untuk Kod Masalah
• Perkhidmatan dan Fail Berkaitan
• Permintaan untuk Maklumat Dadah
• Parameter Pilihan
• Penerangan Elemen Atom Terpilih (atau objek JSON) dalam Memberi Tindak Balas kepada Permintaan Ubat
• Contoh Permintaan untuk Kod Dadah
• Permintaan untuk Maklumat Ujian Makmal
• Parameter Pilihan
• Penerangan Elemen Atom Terpilih (atau objek JSON) dalam Respons terhadap Permintaan Ujian Makmal
• 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 perkhidmatan Web, yang bertindak balas terhadap permintaan berdasarkan:

Anda dipersilakan untuk memautkan dan memaparkan data yang dikembalikan oleh MedlinePlus Connect. Anda tidak boleh menyalin halaman MedlinePlus ke laman web anda. Sekiranya anda menggunakan data dari Perkhidmatan Web MedlinePlus Connect, sila nyatakan bahawa maklumat tersebut berasal dari MedlinePlus.gov tetapi jangan gunakan logo MedlinePlus atau sebaliknya menunjukkan bahawa MedlinePlus menyokong produk tertentu anda. Sila lihat halaman API NLM untuk panduan lebih lanjut. Untuk maklumat lebih lanjut mengenai cara membuat pautan ke kandungan MedlinePlus di luar perkhidmatan ini, sila lihat garis panduan dan arahan kami mengenai pautan.

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.

Gambaran Keseluruhan Perkhidmatan Web

Parameter untuk permintaan perkhidmatan Web sesuai dengan HL7 Context-Aware Knowledge Retrieval (Infobutton) Panduan Pengetahuan Permintaan Berdasarkan URL. Respons berdasarkan REST sesuai dengan Panduan Pelaksanaan Senibina Berorientasikan Perkhidmatan (Infobutton) Pengambilan Pengetahuan Konteks HL7 (Infobutton). Keluaran permintaan boleh berupa XML dalam format suapan Atom, JSON, atau JSONP.

Struktur permintaan menunjukkan jenis kod yang anda hantar. Dalam semua keadaan, URL asas untuk perkhidmatan Web adalah: https://connect.medlineplus.gov/service

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

Parameter Keluaran

Parameter ini adalah pilihan. Sekiranya anda membiarkannya, jawapan lalai adalah maklumat bahasa Inggeris dalam format XML.

Bahasa
Kenal pasti sama ada anda mahukan jawapan 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

Format
Kenal pasti jika anda mahu format respons berupa XML, JSON, atau JSONP. XML adalah lalai.

Untuk meminta JSON, gunakan:

pengetahuanResponseType = aplikasi / json

Untuk JSONP, gunakan:

knowledgeResponseType = application / javascript & callback = CallbackFungsi di mana CallbackFunction adalah nama yang anda berikan fungsi panggilan balik.

Untuk maklum balas dalam XML, gunakan:

knowledgeResponseType = teks / xml atau tinggalkan parameter knowledgeResponseType daripada permintaan.

Permintaan untuk Kod Diagnosis (Masalah)

Untuk kod masalah, MedlinePlus Connect akan mengembalikan pautan dan maklumat dari halaman topik kesihatan MedlinePlus, halaman genetik, atau halaman dari Institut NIH lain.

MedlinePlus Connect akan mengembalikan yang berikut:

Mungkin tidak selalu ada padanan untuk setiap kod. Dalam kes tersebut, MedlinePlus Connect akan memberikan tindak balas nol.

URL asas perkhidmatan adalah: https://connect.medlineplus.gov/service

Terdapat dua parameter yang diperlukan untuk sebarang pertanyaan untuk perkhidmatan ini:

1. Sistem Kod
   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. Kod
   Kenal pasti kod sebenar yang anda cuba cari:
   mainSearchCriteria.v.c = 250.33

Parameter Pilihan

Tajuk Kod
Anda juga boleh mengenal pasti nama / tajuk kod masalah. Walau bagaimanapun, maklumat ini tidak mempengaruhi tindak balas (tidak seperti aplikasi MedlinePlus Connect Web di mana maklumat nama / tajuk boleh digunakan). mainSearchCriteria.v.dn = Diabetes mellitus dengan koma jenis 1 lain yang tidak terkawal Lihat bahagian di atas pada Parameter Keluaran untuk perincian mengenai format bahasa dan output.

Penerangan tentang Elemen Atom Terpilih (atau objek JSON) dalam Menanggapi Permintaan Kod Masalah

Unsur	Nod kelas	Penerangan
tajuk		Tajuk halaman topik kesihatan MedlinePlus atau halaman GHR yang sesuai
pautan		URL untuk halaman topik kesihatan MedlinePlus atau halaman GHR yang sesuai
ringkasan		Ringkasan lengkap untuk topik kesihatan. Ini termasuk pautan tertanam ke topik kesihatan lain yang relevan, dan semua pemformatan, termasuk peluru dan jarak perenggan. Ringkasannya dalam HTML. Untuk halaman GHR, bahagian pertama halaman penuh disediakan.
ringkasan		Sinonim untuk topik tersebut. Ini disebut sebagai "Juga disebut" di halaman topik kesihatan. Tidak semua topik mempunyai istilah "Juga disebut".
ringkasan		Pengakuan atribusi untuk teks ringkasan, jika sebahagian besar ringkasannya berasal dari agensi persekutuan yang lain. Tidak semua ringkasan mempunyai atribusi. Teks tanpa atribut adalah asli dari MedlinePlus.
ringkasan		Pautan terpilih yang berkaitan dengan topik. Ini termasuk nama halaman, URL, dan organisasi yang terkait (jika ada). Pautan diformat dalam senarai bulet. Tidak semua topik mempunyai pautan ini. Jumlah pautan boleh berkisar antara sifar hingga puluhan.

Contoh Permintaan untuk Kod Masalah

Permintaan lengkap untuk Diabetes Mellitus dengan koma jenis 1 lain yang tidak terkawal, kod ICD-9 250.33, untuk pesakit berbahasa Sepanyol akan mempunyai alamat URL berikut: https://connect.medlineplus.gov/service?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 dengan diagnosis yang sama tetapi format yang diminta adalah JSON dan bahasanya adalah bahasa Inggeris: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Seorang pesakit yang didiagnosis dengan "Pneumonia akibat Pseudomonas" menggunakan kod SNOMED CT 41381004: https://connect.medlineplus.gov/service?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

Seorang pesakit dengan diagnosis yang sama tetapi format yang diminta adalah JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&call

Perkhidmatan dan Fail Berkaitan

Untuk menerima topik kesihatan MedlinePlus sebagai respons terhadap permintaan teks, berbanding dengan kod masalah, selidiki perkhidmatan Web MedlinePlus. Juga, jika anda memerlukan set lengkap topik kesihatan MedlinePlus dalam format XML, lihat halaman fail XML kami.

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 jawapan dalam bahasa Inggeris atau Sepanyol.

Untuk permintaan maklumat ubat bahasa Inggeris, jika anda tidak mengirim NDC atau RXCUI atau jika kami tidak menemui padanan berdasarkan kod tersebut, aplikasi akan menggunakan rentetan teks yang anda kirim untuk menampilkan padanan maklumat ubat terbaik. Untuk permintaan maklumat ubat Sepanyol, MedlinePlus Connect hanya bertindak balas terhadap NDC atau RXCUI dan tidak menggunakan rentetan teks. Mungkin ada respon dalam bahasa Inggeris tetapi tidak ada tindak balas dalam bahasa Sepanyol.

Perkhidmatan Web MedlinePlus Connect akan mengembalikan yang berikut:

Mungkin ada banyak respons terhadap satu permintaan ubat. Mungkin tidak selalu ada kecocokan untuk setiap permintaan. Dalam kes tersebut, MedlinePlus Connect akan memberikan tindak balas nol.

Untuk permintaan maklumat dadah, URL asasnya adalah: https://connect.medlineplus.gov/service

Untuk menghantar permintaan, sertakan maklumat ini:

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

   MedlinePlus Connect juga dapat menerima rentetan teks untuk permintaan maklumat ubat dalam bahasa Inggeris, tetapi anda mesti menunjukkan bahawa anda mencari maklumat ubat dengan memasukkan salah satu daripada dua sistem kod yang disenaraikan di atas.
2. Kod
   Kenal pasti kod sebenar yang anda cari. (Disukai untuk Bahasa Inggeris, Wajib untuk Bahasa Sepanyol)
   mainSearchCriteria.v.c = 637188
3. Nama Dadah
   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

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

Parameter Pilihan

Tajuk Kod

Semasa menghantar permintaan untuk maklumat bahasa Inggeris, anda mungkin memasukkan parameter pilihan nama ubat. Ini diperincikan di bahagian di atas. mainSearchCriteria.v.dn = Tablet Lisan Chantix 0.5 MG

Lihat bahagian di atas pada Parameter Keluaran untuk perincian mengenai format bahasa dan output.

Penerangan Elemen Atom Terpilih (atau objek JSON) dalam Memberi Tindak Balas kepada Permintaan Ubat

Unsur	Penerangan
tajuk	Tajuk untuk halaman ubat MedlinePlus yang sesuai
pautan	URL untuk halaman ubat MedlinePlus yang sesuai
pengarang	Atribusi sumber untuk maklumat ubat

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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=637188&mainSearchCriteria.v.dn=Chantix% 200.5% 20MG% 20Lisan% 20Tablet & maklumatRepitient.languageCode.c = en

Untuk meminta maklumat oleh NDC untuk penutur bahasa Sepanyol, permintaan anda akan kelihatan seperti ini: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & maklumatRecipient.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 permintaan Bahasa Inggeris sahaja. Permintaan anda boleh seperti ini: 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. = en

Permintaan untuk Maklumat Ujian Makmal

MedlinePlus Connect memberikan padanan dengan maklumat ujian makmal semasa menerima permintaan LOINC. Perkhidmatan ini dapat memberikan respons dalam bahasa Inggeris atau Sepanyol.

Perkhidmatan Web MedlinePlus Connect akan mengembalikan yang berikut:

Mungkin tidak selalu ada padanan untuk setiap kod. Dalam kes tersebut, MedlinePlus Connect akan memberikan tindak balas nol.

URL asas perkhidmatan adalah: https://connect.medlineplus.gov/service

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

1. Sistem Kod
   

   Kenal pasti bahawa anda menggunakan sistem kod LOINC. Gunakan:

   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. Kod
   kenal pasti kod sebenar yang anda cuba cari:
   mainSearchCriteria.v.c = 3187-2

Parameter Pilihan

Tajuk Kod

Anda juga boleh mengenal pasti nama ujian makmal. Walau bagaimanapun, maklumat ini tidak mempengaruhi tindak balas. mainSearchCriteria.v.dn = Ujian faktor IX

Lihat bahagian di atas pada Parameter Keluaran untuk perincian mengenai format bahasa dan output.

Penerangan Elemen Atom Terpilih (atau objek JSON) dalam Respons terhadap Permintaan Ujian Makmal

Unsur	Penerangan
tajuk	Tajuk halaman ujian makmal MedlinePlus yang dipadankan
pautan	URL untuk halaman ujian makmal MedlinePlus yang sepadan
ringkasan	Coretan dari kandungan halaman
pengarang	Atribusi sumber untuk kandungan ujian makmal

Contoh Permintaan untuk Ujian Makmal

Untuk meminta maklumat penutur bahasa Inggeris, permintaan anda mungkin seperti salah satu daripada yang berikut: 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 = en https://connect.medlineplus.gov/service?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/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&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