MedlinePlus Connect: veb-xizmat

Tarkib

• Veb-xizmatga umumiy nuqtai
• Chiqish parametrlari
• Diagnostika (muammo) kodlari bo'yicha so'rovlar
• Ixtiyoriy parametrlar
• Muammoli kod so'rovlariga javoban tanlangan atom elementlarini (yoki JSON moslamalarini) tavsifi
• Muammo kodlari bo'yicha so'rovlarning namunalari
• Tegishli xizmatlar va fayllar
• Giyohvand moddalar haqida ma'lumot olish uchun so'rovlar
• Ixtiyoriy parametrlar
• Dori-darmon so'rovlariga javoban tanlangan atom elementlarining tavsifi (yoki JSON moslamalari)
• Dori-darmon kodlari bo'yicha so'rovlarga misollar
• Laboratoriya testi ma'lumotlari uchun so'rovlar
• Ixtiyoriy parametrlar
• Laboratoriya sinovlari talablariga javoban tanlangan atom elementlarining tavsifi (yoki JSON moslamalari)
• Laboratoriya sinovlari uchun so'rovlarning namunalari
• Qabul qilinadigan foydalanish qoidalari
• Qo'shimcha ma'lumot

MedlinePlus Connect veb-ilova yoki veb-xizmat sifatida mavjud. Quyida quyidagi talablarga javob beradigan veb-xizmatni amalga oshirishning texnik tafsilotlari keltirilgan.

MedlinePlus Connect tomonidan qaytarilgan ma'lumotlarga havola qilish va ularni namoyish qilish uchun xush kelibsiz. MedlinePlus sahifalarini saytingizga ko'chirishingiz mumkin emas. Agar siz MedlinePlus Connect veb-xizmati ma'lumotlaridan foydalansangiz, iltimos, ma'lumot MedlinePlus.gov-dan olinganligini ko'rsating, lekin MedlinePlus logotipidan foydalanmang yoki boshqacha tarzda MedlinePlus-ning sizning mahsulotingizni qo'llab-quvvatlaganligini bildiradi. Qo'shimcha ma'lumot olish uchun NLM ning API sahifasiga qarang. Ushbu xizmatdan tashqarida MedlinePlus tarkibiga qanday ulanish haqida ko'proq ma'lumot olish uchun bizning ko'rsatmalarimiz va ulanish bo'yicha ko'rsatmalarimizga qarang.

Agar MedlinePlus Connect-dan foydalanishga qaror qilsangiz, ishlanmalarni kuzatib borish va hamkasblaringiz bilan fikr almashish uchun elektron pochta ro'yxatiga yoziling. Iltimos, biz bilan bog'lanish orqali MedlinePlus Connect dasturini amalga oshirayotganingizni ayting.

Veb-xizmatga umumiy nuqtai

Veb-xizmat so'rovlarining parametrlari HL7 kontekstidan xabardor bo'lgan bilimlarni qidirish (Infobutton) ma'lumot so'rovining URL-manziliga asoslangan qo'llanmasiga mos keladi. REST-ga asoslangan javob HL7 kontekstidan xabardor bo'lgan bilimlarni qidirish (Infobutton) xizmatga yo'naltirilgan me'morchilikni amalga oshirish bo'yicha qo'llanma bilan mos keladi. So'rov natijasi Atom tasma formatidagi XML, JSON yoki JSONP bo'lishi mumkin.

So'rovning tuzilishi qaysi turdagi kodni yuborayotganingizni ko'rsatadi. Barcha holatlarda veb-xizmat uchun asosiy URL: https://connect.medlineplus.gov/service

MedlinePlus Connect HTTPS ulanishlaridan foydalanadi. HTTP so'rovlari qabul qilinmaydi va HTTP-dan foydalangan holda amalga oshiriladigan dasturlar HTTPS-ga yangilanishi kerak.

Chiqish parametrlari

Ushbu parametrlar ixtiyoriy. Agar siz ularni qoldirsangiz, standart javob XML formatidagi inglizcha ma'lumotdir.

Til
Javob ingliz yoki ispan tillarida bo'lishini xohlaysizmi, aniqlang. MedlinePlus Connect agar ko'rsatilmagan bo'lsa, ingliz tili deb o'ylaydi.

Muammo kodini qidirishga javobning ispan tilida bo'lishini istasangiz, quyidagidan foydalaning: informationRecipient.languageCode.c = es
(= sp ham qabul qilingan)

Ingliz tilini ko'rsatish uchun quyidagilarni qo'llang: informationRecipient.languageCode.c = uz

Formatlash
Javob formatining XML, JSON yoki JSONP bo'lishini xohlaysizmi, aniqlang. XML standart hisoblanadi.

JSON-ni so'rash uchun quyidagilarni ishlating:

knowledgeResponseType = application / json

JSONP uchun quyidagilardan foydalaning:

knowledgeResponseType = application / javascript & callback = CallbackFunction, bu erda CallbackFunction - bu siz qayta qo'ng'iroq qilish funktsiyasini beradigan nom.

XML-dagi javob uchun quyidagilarni ishlating.

knowledgeResponseType = text / xml yoki knowledgeResponseType parametrini so'rovdan tashqarida qoldiring.

Diagnostika (muammo) kodlari bo'yicha so'rovlar

Muammo kodi uchun MedlinePlus Connect MedlinePlus sog'liqni saqlash mavzusidagi sahifalari, genetika sahifalari yoki boshqa NIH institutlari sahifalaridan havolalar va ma'lumotlarni qaytaradi.

MedlinePlus Connect quyidagilarni qaytaradi:

Har doim har bir kod uchun mos kelmasligi mumkin. Bunday hollarda MedlinePlus Connect null javob qaytaradi.

Xizmatning asosiy URL manzili: https://connect.medlineplus.gov/service

Ushbu xizmatga har qanday so'rov uchun ikkita talab qilinadigan parametr mavjud:

1. Kodlar tizimi
   Siz foydalanadigan muammoli kodlar tizimini aniqlang.

   ICD-10-CM foydalanish uchun:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   ICD-9-CM foydalanish uchun:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   SNOMED CT uchun:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kod
   Siz qidirmoqchi bo'lgan haqiqiy kodni aniqlang:
   mainSearchCriteria.v.c = 250.33

Ixtiyoriy parametrlar

Kod nomi
Muammo kodining nomi / sarlavhasini ham aniqlashingiz mumkin. Biroq, bu ma'lumotlar javobga ta'sir qilmaydi (MedlinePlus Connect veb-ilovasidan farqli o'laroq, ism / sarlavha ma'lumotidan foydalanish mumkin). mainSearchCriteria.v.dn = Diabetes mellitus with other koma type 1 nazoratsiz. Til va chiqish formatlari haqida batafsil ma'lumot olish uchun Chiqish parametrlari bo'limining yuqoridagi bo'limiga qarang.

Muammoli kod so'rovlariga javoban tanlangan atom elementlarini (yoki JSON moslamalarini) tavsifi

Element	Sinf tuguni	Tavsif
sarlavha		Mos keladigan MedlinePlus sog'liqni saqlash mavzusi sahifasi yoki GHR sahifasi nomi
havola		Mos keladigan MedlinePlus sog'liqni saqlash mavzusi sahifasi yoki GHR sahifasi uchun URL
xulosa		Sog'liqni saqlash mavzusi uchun to'liq xulosa. Bunga sog'liq uchun tegishli boshqa mavzularga o'rnatilgan havolalar va barcha formatlash, shu jumladan o'qlar va paragraflar oralig'i kiradi. Xulosa HTML tilida. GHR sahifalari uchun to'liq sahifaning birinchi qismi berilgan.
xulosa		Mavzu uchun sinonimlar. Ular sog'liqni saqlash mavzusidagi sahifada "Shuningdek, deyiladi" deb nomlanadi. Hamma mavzularda "Shuningdek deyiladi" atamalari mavjud emas.
xulosa		Agar xulosaning aksariyati boshqa federal agentlikdan olingan bo'lsa, xulosa matni uchun tasdiqni tasdiqlash. Hamma xulosalar atributga ega emas. Tasdiqlanmagan matn MedlinePlus-ga xosdir.
xulosa		Mavzu bilan bog'liq tanlangan havolalar. Bunga sahifa nomi, URL manzili va tegishli tashkilot (agar kerak bo'lsa) kiradi. Havolalar markerlangan ro'yxatda formatlangan. Barcha mavzularda ushbu havolalar mavjud emas. Havolalar soni noldan o'nlabgacha bo'lishi mumkin.

Muammo kodlari bo'yicha so'rovlarning namunalari

Ispan tilida so'zlashadigan bemor uchun boshqa koma turi 1 nazoratsiz, ICD-9 kodi 250.33 bilan Diabetes Mellitus uchun to'liq so'rov quyidagi URL manzilga ega bo'ladi: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabet% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20controlled & informationRecipient.languageCode.c = es

Xuddi shu tashxis qo'yilgan, lekin so'raladigan format JSON va tili ingliz tilida: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

SNOMED KT kodi 41381004 dan foydalangan holda "Pseudomonas tufayli pnevmoniya" tashxisi qo'yilgan bemor: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&main.ritCeria Pnevmoniya% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = uz

Xuddi shu tashxis qo'yilgan, ammo so'raladigan format JSONP bo'lgan bemor: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javcript&jascript

Tegishli xizmatlar va fayllar

Matline so'rovlariga javoban MedlinePlus sog'liqni saqlash mavzularini olish uchun, muammo kodlaridan farqli o'laroq, MedlinePlus veb-xizmatini tekshiring. Shuningdek, sizga MedlinePlus sog'liqni saqlash mavzularining to'liq to'plami XML formatida kerak bo'lsa, bizning XML fayllar sahifamizga qarang.

Giyohvand moddalar haqida ma'lumot olish uchun so'rovlar

MedlinePlus Connect RXCUI olayotganda eng yaxshi dori-darmonlarga oid ma'lumotlarni taqdim etadi. Bundan tashqari, NDC kodini olishda yaxshi natijalar beradi. MedlinePlus Connect javoblarni ingliz yoki ispan tillarida taqdim etishi mumkin.

Ingliz tili bo'yicha dori-darmonlarga oid ma'lumotlar uchun, agar siz NDC yoki RXCUI-ni yubormasangiz yoki kod asosida mos kelmasa, dastur siz yuborgan matn satridan eng yaxshi dori-darmon haqidagi ma'lumotni namoyish qiladi. Ispaniyalik dorilar haqida ma'lumot olish uchun MedlinePlus Connect faqat NDC yoki RXCUI-larga javob beradi va matn satrlaridan foydalanmaydi. Ingliz tilida javob berish mumkin, ammo ispan tilida javob yo'q.

MedlinePlus Connect veb-xizmati quyidagilarni qaytaradi:

Bir dori so'roviga bir nechta javob bo'lishi mumkin. Har bir so'rov uchun har doim ham mos kelmasligi mumkin. Bunday hollarda MedlinePlus Connect null javob qaytaradi.

Giyohvand moddalar to'g'risida ma'lumot olish uchun asosiy URL manzili: https://connect.medlineplus.gov/service

So'rov yuborish uchun quyidagi ma'lumotlarni kiriting:

1. Kodlar tizimi
   Siz yuboradigan dori kodining turini aniqlang. (Ingliz va ispan tillari uchun talab qilinadi)
   

   RXCUI foydalanish uchun:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   NDC foydalanish uchun:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect, shuningdek, ingliz tilidagi dori-darmonlarga oid ma'lumotlar uchun so'rovlar uchun matnli qatorni qabul qilishi mumkin, ammo siz yuqorida sanab o'tilgan ikkita kod tizimidan birini qo'shib, dori-darmon haqida ma'lumot qidirayotganingizni ko'rsatishingiz kerak.
2. Kod
   Siz qidirmoqchi bo'lgan haqiqiy kodni aniqlang. (Ingliz tili uchun afzal, Ispaniya uchun talab qilinadi)
   mainSearchCriteria.v.c = 637188
3. Dori nomi
   Matn qatori bilan preparatning nomini aniqlang. (Ingliz tili uchun ixtiyoriy, ispan tilida ishlatilmaydi)
   mainSearchCriteria.v.dn = Chantix 0,5 MG og'iz tabletkasi

Kamida siz kod tizimini va kodni, yoki kod tizimini va preparatning nomini aniqlashingiz kerak. Ingliz tilidagi so'rovlar uchun eng yaxshi natijalarga erishish uchun uchalasini ham yuboring. Kod tizimini va ispan tilidagi so'rovlar uchun kodni yuboring.

Ixtiyoriy parametrlar

Kod nomi

Inglizcha ma'lumot olish uchun so'rov yuborayotganda siz dori nomining ixtiyoriy parametrini kiritishingiz mumkin. Bu yuqoridagi bo'limda batafsil bayon etilgan. mainSearchCriteria.v.dn = Chantix 0,5 MG og'iz tabletkasi

Til va chiqish formatlari haqida batafsil ma'lumot olish uchun yuqoridagi Chiqish parametrlari bo'limiga qarang.

Dori-darmon so'rovlariga javoban tanlangan atom elementlarining tavsifi (yoki JSON moslamalari)

Element	Tavsif
sarlavha	Mos keladigan MedlinePlus dori-darmonlari sahifasi uchun sarlavha
havola	Mos keladigan MedlinePlus dori-darmonlari sahifasi uchun URL
muallif	Dori-darmonlarga oid ma'lumotlarning manbalari

Dori-darmon kodlari bo'yicha so'rovlarga misollar

Dori-darmon haqida ma'lumot so'rovingiz quyidagilardan biriga o'xshash bo'lishi kerak.

RXCUI tomonidan ma'lumot so'rash uchun sizning so'rovingiz quyidagicha bo'lishi kerak: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=637188&mainSearchCriteria.v.dn=Chant% 200.5% 20MG% 20Oral% 20Tablet & informationRecipient.languageCode.c = uz

Ispaniyalik ma'ruzachi uchun MDH tomonidan ma'lumot so'rash uchun sizning so'rovingiz quyidagicha bo'lishi kerak: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Matn qatorini dori kodisiz yuborish uchun siz so'rovingizni NDC tipidagi so'rov sifatida aniqlab olishingiz kerak, shunda MedlinePlus Connect dori-darmon haqida ma'lumot qidirayotganingizni biladi. Bu faqat ingliz tilidagi so'rovlar uchun ishlaydi. Sizning so'rovingiz shunday bo'lishi mumkin: 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.language = uz

Laboratoriya testi ma'lumotlari uchun so'rovlar

MedlinePlus Connect LOINC so'rovini qabul qilganda laboratoriya sinovlari ma'lumotlariga mos keladi. Xizmat ingliz yoki ispan tillarida javobni taqdim etishi mumkin.

MedlinePlus Connect veb-xizmati quyidagilarni qaytaradi:

Har doim har bir kod uchun mos kelmasligi mumkin. Bunday hollarda MedlinePlus Connect null javob qaytaradi.

Xizmatning asosiy URL manzili: https://connect.medlineplus.gov/service

Ushbu xizmat uchun har qanday laboratoriya sinovi uchun ikkita talab qilinadigan parametr:

1. Kodlar tizimi
   

   LOINC kod tizimidan foydalanayotganingizni aniqlang. Foydalanish:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect shuningdek quyidagilarni qabul qiladi:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kod
   qidirmoqchi bo'lgan haqiqiy kodni aniqlang:
   mainSearchCriteria.v.c = 3187-2

Ixtiyoriy parametrlar

Kod nomi

Laboratoriya testining nomini ham aniqlab olishingiz mumkin. Biroq, bu ma'lumot javobga ta'sir qilmaydi. mainSearchCriteria.v.dn = IX faktor tahlili

Til va chiqish formatlari haqida batafsil ma'lumot olish uchun yuqoridagi Chiqish parametrlari bo'limiga qarang.

Laboratoriya sinovlari talablariga javoban tanlangan atom elementlarining tavsifi (yoki JSON moslamalari)

Element	Tavsif
sarlavha	Mos keladigan MedlinePlus laboratoriya test sahifasining nomi
havola	Mos keladigan MedlinePlus laboratoriya test sahifasi uchun URL
xulosa	Sahifa tarkibidan parcha
muallif	Laboratoriya testi tarkibiga manba atributi

Laboratoriya sinovlari uchun so'rovlarning namunalari

Ingliz tilida so'zlashuvchi uchun ma'lumot so'rash uchun sizning so'rovingiz quyidagilardan biriga o'xshash bo'lishi mumkin: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 20IX% 20assay & informationRecipient.languageCode.c = uz https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecip. = uz

Ispaniyalik ma'ruzachi uchun ma'lumot so'rash uchun sizning so'rovingiz quyidagilardan biriga o'xshab ko'rinishi mumkin: https://connect.medlineplus.gov/service?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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecip. = es

Qabul qilinadigan foydalanish qoidalari

MedlinePlus serverlarini ortiqcha yuklamaslik uchun NLM MedlinePlus Connect foydalanuvchilari har bir IP-manzil uchun daqiqada 100 dan ortiq so'rov yuborishini talab qiladi. Ushbu limitdan oshib ketgan so'rovlarga xizmat ko'rsatilmaydi va 300 soniya davomida yoki so'rov darajasi chegara ostiga tushguncha, qaysi biri keyinroq kelsa, xizmat tiklanmaydi. Connect-ga yuboradigan so'rovlar sonini cheklash uchun NLM keshlash natijalarini 12-24 soat davomida tavsiya qiladi.

Ushbu siyosat xizmatning barcha foydalanuvchilar uchun mavjud bo'lishini ta'minlash uchun amal qiladi. Agar sizda MedlinePlus Connect-ga ko'p sonli so'rovlarni yuborishingizni talab qiladigan va shu sababli ushbu siyosatda ko'rsatilgan so'rov stavkasining chegarasidan oshib ketishingizni talab qiladigan ma'lum bir ishingiz bo'lsa, biz bilan bog'laning. NLM xodimlari sizning so'rovingizni baholaydilar va istisno berilishi mumkinligini aniqlaydilar. Iltimos, MedlinePlus XML fayllari hujjatlarini ko'rib chiqing. Ushbu XML fayllari to'liq sog'liqni saqlash mavzusidagi yozuvlarni o'z ichiga oladi va MedlinePlus ma'lumotlariga kirishning muqobil usuli sifatida xizmat qilishi mumkin.

Qo'shimcha ma'lumot