MedlinePlus Connect: سرویس وب

محتوا

• بررسی اجمالی سرویس وب
• پارامترهای خروجی
• درخواست کدهای تشخیص (مشکل)
• پارامترهای اختیاری
• شرح عناصر اتمی انتخاب شده (یا اشیا J JSON) در پاسخ به درخواست های کد مسئله
• نمونه هایی از درخواست ها برای کدهای مسئله
• خدمات و پرونده های مرتبط
• درخواست اطلاعات دارویی
• پارامترهای اختیاری
• شرح عناصر اتمی انتخاب شده (یا اشیا J JSON) در پاسخ به درخواست های دارویی
• نمونه هایی از درخواست های کد دارویی
• درخواست اطلاعات آزمایشگاهی
• پارامترهای اختیاری
• شرح عناصر اتمی انتخاب شده (یا اشیا J JSON) در پاسخ به درخواستهای آزمایشگاه
• نمونه هایی از درخواست های آزمایشات آزمایشگاهی
• سیاست استفاده قابل قبول
• اطلاعات بیشتر

MedlinePlus Connect به عنوان یک برنامه وب یا سرویس وب در دسترس است. در زیر جزئیات فنی پیاده سازی سرویس وب ارائه شده است که به درخواستها بر اساس موارد زیر پاسخ می دهد:

شما می توانید داده های برگشت شده توسط MedlinePlus Connect را پیوند داده و نمایش دهید. شما نمی توانید صفحات MedlinePlus را در سایت خود کپی کنید. اگر از داده های سرویس وب MedlinePlus Connect استفاده می کنید ، لطفاً بگویید که اطلاعات مربوط به MedlinePlus.gov است اما از آرم MedlinePlus استفاده نکنید یا در غیر این صورت به این معنی است که MedlinePlus محصول خاص شما را تأیید می کند. لطفاً برای راهنمایی بیشتر به صفحه API NLM مراجعه کنید. برای کسب اطلاعات بیشتر در مورد نحوه پیوند دادن به محتوای MedlinePlus خارج از این سرویس ، لطفاً به راهنمایی ها و دستورالعمل های مربوط به پیوند مراجعه کنید.

اگر تصمیم دارید از MedlinePlus Connect استفاده کنید ، در لیست ایمیل ثبت نام کنید تا در جریان پیشرفت ها قرار بگیرید و با همکاران خود ایده تبادل کنید. لطفاً در صورت اجرای MedlinePlus Connect با تماس با ما به ما بگویید.

بررسی اجمالی سرویس وب

پارامترهای درخواست های وب سرویس با راهنمای پیاده سازی مبتنی بر URL درخواست دانش دانش HL7 Context-Aware Knowledge بازیابی (Infobutton) مطابقت دارند. پاسخ مبتنی بر REST با راهنمای پیاده سازی معماری مبتنی بر سرویس HL7 متناسب با آگاهی از دانش (Infobutton) مطابقت دارد. خروجی درخواست می تواند XML در قالب Atom feed ، JSON یا JSONP باشد.

ساختار درخواست نشان می دهد چه نوع کدی را ارسال می کنید. در همه موارد ، URL اصلی سرویس وب این است: https://connect.medlineplus.gov/service

MedlinePlus Connect از اتصالات HTTPS استفاده می کند. درخواست های HTTP پذیرفته نمی شوند و پیاده سازی های موجود با استفاده از HTTP باید به HTTPS به روز شوند.

پارامترهای خروجی

این پارامترها اختیاری هستند. اگر آنها را کنار بگذارید ، پاسخ پیش فرض اطلاعات انگلیسی در قالب XML است.

زبان
اگر می خواهید پاسخ به زبان انگلیسی یا اسپانیایی باشد مشخص کنید. اگر MedlinePlus Connect مشخص نشود ، زبان انگلیسی است.

اگر می خواهید پاسخ به جستجوی کد مسئله به زبان اسپانیایی باشد ، از: informationRecipient.languageCode.c = es استفاده کنید
(= sp نیز پذیرفته شد)

برای مشخص کردن زبان انگلیسی ، از موارد زیر استفاده کنید: informationRecipient.languageCode.c = en

قالب بندی
اگر می خواهید قالب پاسخ XML ، JSON یا JSONP باشد ، مشخص کنید. XML پیش فرض است.

برای درخواست JSON ، از موارد زیر استفاده کنید:

knowledgeResponseType = application / json

برای JSONP استفاده کنید:

knowledgeResponseType = application / javascript & callback = عملکرد برگشتی که در آن CallbackFunction نامی است که شما عملکرد برگشت تماس را می دهید.

برای پاسخ در XML ، از موارد زیر استفاده کنید:

KnowledgeResponseType = text / xml یا پارامتر KnowLResponseType را از درخواست خارج کنید.

درخواست کدهای تشخیص (مشکل)

برای کد مشکلی ، MedlinePlus Connect پیوندها و اطلاعات را از صفحه های موضوع بهداشت MedlinePlus ، صفحات ژنتیک یا صفحات سایر موسسات NIH باز می گرداند.

MedlinePlus Connect موارد زیر را برمی گرداند:

همیشه ممکن است برای هر کد تطابق وجود نداشته باشد. در این موارد ، MedlinePlus Connect پاسخی صفر خواهد داد.

URL اصلی سرویس: https://connect.medlineplus.gov/service

برای هر درخواست در این سرویس دو پارامتر مورد نیاز وجود دارد:

1. سیستم کد
   سیستم کد مسئله ای را که استفاده می کنید شناسایی کنید.

   برای استفاده از ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   برای استفاده از ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   برای استفاده از SNOMED CT:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. کد
   کد واقعی را که می خواهید جستجو کنید شناسایی کنید:
   mainSearchCriteria.v.c = 250.33

پارامترهای اختیاری

عنوان کد
همچنین می توانید نام / عنوان کد مسئله را شناسایی کنید. با این حال ، این اطلاعات بر پاسخ تأثیر نمی گذارد (بر خلاف برنامه MedlinePlus Connect Web که ممکن است از اطلاعات نام / عنوان استفاده شود). mainSearchCriteria.v.dn = دیابت شیرین با سایر نوع کمای کنترل نشده 1 برای کنترل جزئیات در مورد زبان و قالب های خروجی به بخش فوق در پارامترهای خروجی مراجعه کنید.

شرح عناصر اتمی انتخاب شده (یا اشیا J JSON) در پاسخ به درخواست های کد مسئله

عنصر	گره کلاس	شرح
عنوان		عنوان صفحه موضوع سلامت MedlinePlus یا صفحه GHR منطبق شده
ارتباط دادن		URL برای صفحه موضوع سلامت MedlinePlus یا صفحه GHR
خلاصه		خلاصه کامل موضوع سلامت. این شامل پیوندهای جاسازی شده به سایر موضوعات مرتبط بهداشتی و کلیه قالب بندی ها ، از جمله گلوله و فاصله پاراگراف است. خلاصه به زبان HTML است. برای صفحات GHR ، اولین بخش از صفحه کامل ارائه شده است.
خلاصه		مترادف موضوع. در صفحه مبحث سلامت به این موارد "همچنین گفته می شود" گفته می شود. همه عناوین دارای اصطلاحات "همچنین نامیده می شوند" نیستند.
خلاصه		تأیید صلاحیت برای متن خلاصه ، اگر اکثر خلاصه ها مربوط به آژانس فدرال دیگری باشد. همه خلاصه ها انتسابی ندارند. متن بدون ویژگی اصلی در MedlinePlus است.
خلاصه		پیوندهای انتخاب شده مرتبط با موضوع. این شامل نام صفحه ، URL و سازمان مرتبط است (در صورت لزوم). پیوندها در یک لیست پرگل قالب بندی می شوند. همه مباحث این پیوندها را ندارند. تعداد پیوندها می تواند از صفر تا ده ها باشد.

نمونه هایی از درخواست ها برای کدهای مسئله

یک درخواست کامل برای دیابت شیرین با سایر موارد کنترل نشده کما نوع 1 ، کد ICD-9 250.33 ، برای یک بیمار اسپانیایی زبان آدرس URL زیر را دارد: https://connect.medlineplus.gov/service؟mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = دیابت٪ 20 قشر٪ 20 با٪ 20 دیگر٪ 20 کما٪ 20 نوع٪ 201٪ 20 کنترل نشده & informationRecipient.languageCode.c = es

یک بیمار با همان تشخیص ، اما قالب درخواست شده JSON است و زبان انگلیسی است: https://connect.medlineplus.gov/service؟mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33& KnowledgeResponseType=application / json

یک بیمار مبتلا به "ذات الریه ناشی از سودوموناس" با استفاده از کد SNOMED CT 41381004 تشخیص داده شده است: https://connect.medlineplus.gov/service؟mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=4138100d&main ذات الریه٪ 20 علت٪ 20 تا٪ 20 سودوموناس٪ 20٪ 28 اختلال٪ 29 و اطلاعاتRecipient.languageCode.c = en

یک بیمار با همان تشخیص ، اما قالب درخواست شده JSONP است: https://connect.medlineplus.gov/service؟mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004& KnowledgeResponseType=application&jack&application/justin/justin/application/justin/application/justin/application/justin/application/justin/application

خدمات و پرونده های مرتبط

برای دریافت مباحث بهداشتی MedlinePlus در پاسخ به درخواست های متنی ، در مقابل کدهای مشکل ، سرویس وب MedlinePlus را بررسی کنید. همچنین ، اگر به مجموعه کامل مباحث مربوط به سلامت MedlinePlus در قالب XML نیاز دارید ، به صفحه پرونده های XML ما مراجعه کنید.

درخواست اطلاعات دارویی

هنگام دریافت RXCUI ، MedlinePlus Connect بهترین اطلاعات مربوط به دارو را فراهم می کند. همچنین هنگام دریافت کد NDC نتایج خوبی ارائه می دهد. MedlinePlus Connect می تواند پاسخ ها را به زبان انگلیسی یا اسپانیایی ارائه دهد.

در صورت درخواست اطلاعات دارویی انگلیسی ، اگر NDC یا RXCUI نفرستید یا بر اساس کد موردی مطابقت ندارید ، برنامه از رشته متنی که ارسال می کنید استفاده می کند تا بهترین اطلاعات مربوط به دارو را نشان دهد. برای درخواست اطلاعات دارویی اسپانیایی ، MedlinePlus Connect فقط به NDC یا RXCUI پاسخ می دهد و از رشته های متنی استفاده نمی کند. پاسخ به زبان انگلیسی ممکن است اما پاسخ به اسپانیایی امکان پذیر نیست.

خدمات وب MedlinePlus Connect موارد زیر را برمی گرداند:

می تواند چندین پاسخ به یک درخواست دارویی داشته باشد. همیشه ممکن است برای هر درخواست مطابقت نداشته باشد. در این موارد ، MedlinePlus Connect پاسخی صفر می دهد.

برای درخواست اطلاعات دارویی ، URL اصلی این است: https://connect.medlineplus.gov/service

برای ارسال درخواست ، این اطلاعات را وارد کنید:

1. سیستم کد
   نوع کد دارویی را که ارسال می کنید شناسایی کنید. (برای انگلیسی و اسپانیایی لازم است)
   

   برای استفاده از RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   برای استفاده از NDC:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect همچنین می تواند رشته متنی را برای درخواست اطلاعات دارویی به زبان انگلیسی بپذیرد ، اما باید با درج یکی از دو سیستم کد ذکر شده در بالا ، نشان دهید که به دنبال اطلاعات دارویی هستید.
2. کد
   کد واقعی را که می خواهید جستجو کنید شناسایی کنید. (برای انگلیسی ترجیح داده می شود ، برای اسپانیایی لازم است)
   mainSearchCriteria.v.c = 637188
3. نام دارو
   نام دارو را با یک رشته متن مشخص کنید. (اختیاری برای انگلیسی ، برای اسپانیایی استفاده نمی شود)
   mainSearchCriteria.v.dn = قرص خوراکی 0.5 میلی گرم Chantix

حداقل باید سیستم کد و کد یا سیستم کد و نام دارو را شناسایی کنید. برای دستیابی به بهترین نتیجه برای درخواست های انگلیسی ، هر سه را ارسال کنید. سیستم کد و کد را برای درخواست های اسپانیایی ارسال کنید.

پارامترهای اختیاری

عنوان کد

هنگام ارسال درخواست اطلاعات انگلیسی ، ممکن است پارامتر اختیاری نام دارو را در آن بگنجانید. این در بخش فوق شرح داده شده است. mainSearchCriteria.v.dn = قرص خوراکی 0.5 میلی گرم Chantix

برای جزئیات بیشتر در مورد فرمتهای زبان و خروجی ، به بخش فوق در پارامترهای خروجی مراجعه کنید.

شرح عناصر اتمی انتخاب شده (یا اشیا J JSON) در پاسخ به درخواست های دارویی

عنصر	شرح
عنوان	عنوان صفحه مطابقت داروی MedlinePlus
ارتباط دادن	URL برای صفحه دارویی مطابق با MedlinePlus
نویسنده	انتساب منبع برای اطلاعات دارویی

نمونه هایی از درخواست های کد دارویی

درخواست اطلاعات دارویی شما باید مانند یکی از موارد زیر باشد.

برای درخواست اطلاعات توسط RXCUI ، درخواست شما باید به صورت زیر باشد: 200.5٪ 20MG٪ 20 دهان٪ 20 جدول و اطلاعات Recipient.languageCode.c = en

برای درخواست اطلاعات توسط NDC برای یک سخنران اسپانیایی ، درخواست شما باید به این شکل باشد: https://connect.medlineplus.gov/service؟mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

برای ارسال یک رشته متنی بدون کد دارو ، باید درخواست خود را به عنوان درخواست نوع NDC شناسایی کنید تا MedlinePlus Connect بداند که به دنبال اطلاعات دارویی هستید. این فقط برای درخواست های انگلیسی کاربرد دارد. درخواست شما می تواند به این شکل باشد: = en

درخواست اطلاعات آزمایشگاهی

هنگام دریافت درخواست LOINC ، MedlinePlus Connect مطابقت با اطلاعات آزمایشگاه را فراهم می کند. این سرویس می تواند به انگلیسی یا اسپانیایی پاسخ دهد.

خدمات وب MedlinePlus Connect موارد زیر را برمی گرداند:

همیشه ممکن است برای هر کد تطابق وجود نداشته باشد. در این موارد ، MedlinePlus Connect پاسخی صفر می دهد.

URL اصلی سرویس: https://connect.medlineplus.gov/service

این دو پارامتر مورد نیاز برای هرگونه پرسش آزمایشگاهی برای این سرویس است:

1. سیستم کد
   

   مشخص کنید که از سیستم کد LOINC استفاده می کنید. استفاده کنید:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect نیز موارد زیر را می پذیرد:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. کد
   کد واقعی را که می خواهید جستجو کنید شناسایی کنید:
   mainSearchCriteria.v.c = 3187-2

پارامترهای اختیاری

عنوان کد

شما همچنین می توانید نام آزمایشگاه را شناسایی کنید. با این حال ، این اطلاعات بر پاسخ تأثیر نمی گذارد. mainSearchCriteria.v.dn = سنجش فاکتور IX

برای جزئیات بیشتر در مورد فرمتهای زبان و خروجی ، به بخش فوق در پارامترهای خروجی مراجعه کنید.

شرح عناصر اتمی انتخاب شده (یا اشیا J JSON) در پاسخ به درخواستهای آزمایشگاه

عنصر	شرح
عنوان	عنوان صفحه آزمایشگاه مطابق MedlinePlus
ارتباط دادن	URL برای صفحه آزمایش آزمایش شده MedlinePlus
خلاصه	قطعه ای از محتوای صفحه
نویسنده	انتساب منبع برای محتوای آزمون آزمایشگاهی

نمونه هایی از درخواست های آزمایشات آزمایشگاهی

برای درخواست اطلاعات برای یک انگلیسی زبان ، ممکن است درخواست شما یکی از موارد زیر باشد: https://connect.medlineplus.gov/service؟mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v. = en

برای درخواست اطلاعات برای یک سخنران اسپانیایی ، درخواست شما ممکن است یکی از موارد زیر باشد: v.dn = عامل٪ 20IX٪ 20 ارزیابی = es

سیاست استفاده قابل قبول

به منظور جلوگیری از بارگذاری بیش از حد سرورهای MedlinePlus ، NLM نیاز دارد که کاربران MedlinePlus Connect بیش از 100 درخواست در دقیقه به ازای هر آدرس IP ارسال نکنند. درخواستهایی که بیش از این حد باشند خدمات ارائه نخواهند شد و خدمات برای 300 ثانیه یا تا زمانی که نرخ درخواست در زیر حد مجاز سقوط نکند ، هر کدام که بعداً بیاید ، بازیابی نمی شوند. برای محدود کردن تعداد درخواستهایی که به Connect ارسال می کنید ، NLM نتایج ذخیره را برای مدت 24-24 ساعت توصیه می کند.

این سیاست برای اطمینان از در دسترس بودن و در دسترس بودن سرویس برای همه کاربران موجود است. اگر مورد استفاده خاصی دارید که شما را ملزم به ارسال تعداد زیادی درخواست به MedlinePlus Connect می کند و بنابراین از حداکثر نرخ درخواست که در این قانون ذکر شده است ، فراتر می رود ، لطفا با ما تماس بگیرید کارکنان NLM درخواست شما را ارزیابی می کنند و تعیین می کنند که آیا استثنایی پذیرفته شده است. لطفاً مستندات پرونده های MedlinePlus XML را نیز مرور کنید. این پرونده های XML حاوی سوابق کامل موضوعات مربوط به سلامت هستند و می توانند به عنوان یک روش جایگزین برای دسترسی به داده های MedlinePlus عمل کنند.

اطلاعات بیشتر