MedlinePlus Connect: Вэб үйлчилгээ

Сэтгэл Ханамжтай

• Вэб үйлчилгээний тойм
• Гаралтын параметрүүд
• Оношлогооны хүсэлт (Асуудал) код
• Нэмэлт параметрүүд
• Асуудлын кодын хүсэлтийн дагуу сонгосон атомын элементүүдийн тодорхойлолт (эсвэл JSON объект)
• Асуудлын кодын хүсэлтийн жишээ
• Холбогдох үйлчилгээ ба файлууд
• Мансууруулах бодисын талаархи хүсэлт
• Нэмэлт параметрүүд
• Эмийн хүсэлтийн дагуу сонгосон атомын элементүүдийн тодорхойлолт (эсвэл JSON объект)
• Эмийн кодын хүсэлтийн жишээ
• Лабораторийн шинжилгээний мэдээлэл авах хүсэлт
• Нэмэлт параметрүүд
• Лабораторийн шинжилгээний хүсэлтийн дагуу сонгосон атомын элементүүд (эсвэл JSON объектууд) -ын тодорхойлолт
• Лабораторийн шинжилгээний хүсэлтийн жишээ
• Зөвшөөрөгдсөн хэрэглээний бодлого
• Нэмэлт мэдээлэл

MedlinePlus Connect нь вэб програм эсвэл вэб үйлчилгээ хэлбэрээр ашиглах боломжтой. Вэб үйлчилгээг хэрэгжүүлэх техникийн дэлгэрэнгүй мэдээллийг доор харуулав.

MedlinePlus Connect-ийн буцаасан өгөгдлийг холбох, харуулахыг урьж байна. Та MedlinePlus хуудсыг өөрийн сайт руу хуулж болохгүй. Хэрэв та MedlinePlus Connect вэб үйлчилгээний өгөгдлийг ашиглаж байгаа бол MedlinePlus.gov-оос мэдээлэл авсан гэдгээ мэдэгдээрэй, гэхдээ MedlinePlus лого ашиглаагүй эсвэл MedlinePlus нь таны тухайн бүтээгдэхүүнийг дэмжиж байгааг илтгэнэ үү. Дэлгэрэнгүй мэдээллийг NLM-ийн API хуудаснаас авна уу. Энэ үйлчилгээнээс гадуур MedlinePlus-ийн агуулгыг хэрхэн яаж холбох талаар дэлгэрэнгүй мэдээлэл авахыг хүсвэл манай удирдамж, холбоосын зааврыг үзнэ үү.

Хэрэв та MedlinePlus Connect-ийг ашиглахаар шийдсэн бол хөгжлөөс хоцрохгүй байх, хамт олонтойгоо санал бодлоо солилцохын тулд имэйлийн жагсаалтад бүртгүүлнэ үү. Хэрэв та MedlinePlus Connect програмыг бидэнтэй холбоо барьж хэрэгжүүлж байгаа бол бидэнд хэлнэ үү.

Вэб үйлчилгээний тойм

Вэб үйлчилгээний хүсэлтийн параметрүүд нь HL7 контекстийг мэддэг мэдлэг олж авах (Мэдээллийн товч) Мэдлэгийн хүсэлтийн URL-д суурилсан хэрэгжүүлэх гарын авлагад нийцдэг. REST дээр суурилсан хариу арга хэмжээ нь HL7 контекстийг мэддэг мэдлэг олж авах (Infobutton) үйлчилгээнд чиглэсэн архитектурыг хэрэгжүүлэх гарын авлагад нийцэж байна. Хүсэлтийн үр дүн нь Atom feed формат, JSON эсвэл JSONP дахь XML байж болно.

Хүсэлтийн бүтэц нь ямар төрлийн код илгээж байгааг заана. Бүх тохиолдолд Вэб үйлчилгээний үндсэн URL нь: https://connect.medlineplus.gov/service

MedlinePlus Connect нь HTTPS холболтыг ашигладаг. HTTP хүсэлтийг хүлээн авахгүй бөгөөд HTTP ашиглаж буй хэрэгжүүлэлтүүд HTTPS болж шинэчлэгдэх ёстой.

Гаралтын параметрүүд

Эдгээр параметрүүд нь заавал биш юм. Хэрэв та тэдгээрийг орхисон бол анхдагч хариу нь XML форматтай англи хэлний мэдээлэл юм.

Хэл
Хариу нь англи эсвэл испани хэл дээр байхыг хүсч байгаа эсэхийг тодорхойл. MedlinePlus Connect нь заагаагүй бол англи хэл юм гэж үзнэ.

Хэрэв та асуудлын кодын хариуг испани хэлээр авахыг хүсвэл дараахь зүйлийг ашиглана уу: informationRecipient.languageCode.c = es
(= мөн хүлээн зөвшөөрөгдсөн)

Англи хэлийг зааж өгөхийн тулд дараахь зүйлийг ашиглана уу: informationRecipient.languageCode.c = en

Формат
Хариултын форматыг XML, JSON эсвэл JSONP байхыг хүсч байгаа эсэхийг тодорхойл. XML нь анхдагч юм.

JSON-ээс хүсэлт гаргахын тулд дараахь зүйлийг ашиглана уу.

knowledgeResponseType = application / json

JSONP-ийн хувьд дараахь зүйлийг ашиглана уу.

knowledgeResponseType = application / javascript & callback = CallbackFunction бол CallbackFunction нь буцааж дуудлага хийх функцийг өгдөг нэр юм.

XML-д хариулахын тулд дараахь зүйлийг ашиглана уу.

knowledgeResponseType = text / xml эсвэл knowledgeResponseType параметрийг хүсэлтээс гадуур үлдээнэ үү.

Оношлогооны хүсэлт (Асуудал) код

Асуудлын кодын хувьд 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 вэб програмаас ялгаатай). mainSearchCriteria.v.dn = Чихрийн шижин, бусад комын 1-р хэлбэрийн хяналтгүй байдал, Гаралтын параметрийн дээрх хэсгийг хэл, гаралтын форматын талаар дэлгэрэнгүй үзнэ үү.

Асуудлын кодын хүсэлтийн дагуу сонгосон атомын элементүүдийн тодорхойлолт (эсвэл JSON объект)

Элемент	Ангийн зангилаа	Тодорхойлолт
гарчиг		Тохирсон MedlinePlus эрүүл мэндийн сэдэвтэй хуудас эсвэл GHR хуудасны гарчиг
холбоос		Тохирсон MedlinePlus эрүүл мэндийн сэдэв хуудас эсвэл GHR хуудасны URL
хураангуй		Эрүүл мэндийн сэдэвт бүрэн тойм. Үүнд эрүүл мэндийн бусад холбогдох сэдвүүдийн суулгагдсан холбоосууд, сум, параграфын зай зэрэг бүх форматлалт орно. Хураангуй нь 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 = Чихрийн шижин% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20controlled & 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 ашиглан "Pseudomonas-ийн улмаас уушгины хатгалгаа" оношлогдсон өвчтөн: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainvritCeria Уушгины хатгалгаа% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.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/javcript&jascript

Холбогдох үйлчилгээ ба файлууд

Асуудлын кодоос ялгаатай нь текст хүсэлтийн дагуу MedlinePlus эрүүл мэндийн сэдвүүдийг хүлээн авахын тулд MedlinePlus вэб үйлчилгээг шалгана уу. Мөн танд MedlinePlus эрүүл мэндийн сэдвүүдийн бүрэн багцыг XML форматаар авах шаардлагатай бол манай XML файлын хуудсыг үзнэ үү.

Мансууруулах бодисын талаархи хүсэлт

MedlinePlus Connect нь RXCUI хүлээн авахдаа эмийн талаархи хамгийн сайн мэдээллийг өгдөг. Энэ нь ДҮТ кодыг хүлээн авахад сайн үр дүн өгдөг. MedlinePlus Connect нь хариултыг англи эсвэл испани хэлээр өгөх боломжтой.

Англи хэлний эмийн талаархи мэдээллийг авахын тулд хэрэв та ДҮТ эсвэл 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

   ДҮТ-ийн хувьд:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect нь эмийн талаархи мэдээллийг англи хэл дээр авахыг хүссэн текст мөрийг хүлээн авах боломжтой боловч та дээр дурдсан хоёр кодын системийн аль нэгийг оруулаад эмийн талаар мэдээлэл хайж байгаагаа илэрхийлэх ёстой.
2. Код
   Хайх гэж байгаа бодит кодоо тодорхойл. (Англи хэл дээр илүүд үздэг, Испани хэл дээр шаардлагатай)
   mainSearchCriteria.v.c = 637188
3. Эмийн нэр
   Текстийн мөрөөр эмийн нэрийг тодорхойлно уу. (Испани хэл дээр ашиглаагүй, англи хэл дээр заавал хийх боломжтой)
   mainSearchCriteria.v.dn = Chantix 0.5 MG аман таблет

Наад зах нь та кодын систем, кодыг эсвэл кодын систем, эмийн нэрийг тодорхойлох хэрэгтэй. Англи хэлний хүсэлтийг хамгийн сайн үр дүнд хүргэхийн тулд гурвууланг нь явуулна уу. Испанийн хүсэлтийн кодын систем болон кодыг илгээнэ үү.

Нэмэлт параметрүүд

Кодын гарчиг

Англи хэлний мэдээлэл авах хүсэлт илгээхдээ та эмийн нэрийн сонголтын параметрийг оруулж болно. Энэ талаар дээрх хэсэгт дэлгэрэнгүй тайлбарласан болно. mainSearchCriteria.v.dn = Chantix 0.5 MG аман таблет

Хэлний болон гаралтын форматын талаархи дэлгэрэнгүй мэдээллийг Output Parameters дээрх хэсгээс үзнэ үү.

Эмийн хүсэлтийн дагуу сонгосон атомын элементүүдийн тодорхойлолт (эсвэл JSON объект)

Элемент	Тодорхойлолт
гарчиг	Тохирсон MedlinePlus эмийн хуудасны гарчиг
холбоос	Тохирсон MedlinePlus эмийн хуудасны URL
зохиогч	Эмийн талаархи мэдээллийн эх сурвалж

Эмийн кодын хүсэлтийн жишээ

Таны эмийн талаархи мэдээлэл дараахь зүйлсийн аль нэгтэй адил байх ёстой.

RXCUI-ийн талаар мэдээлэл авахыг хүсвэл дараахь хэлбэртэй байна: 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% 20Oral% 20Tablet & informationRecipient.languageCode.c = en

Испани хэлээр ярьдаг хүнд ҮХЦ-ээс мэдээлэл хүсэхийн тулд таны хүсэлт дараах байдалтай байна: 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 нь эмийн талаархи мэдээллийг хайж байгаагаа мэдэж байх болно. Энэ нь зөвхөн англи хэл дээрх хүсэлтийн дагуу ажиллах болно. Таны хүсэлт дараах байдалтай байж магадгүй юм: 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

Лабораторийн шинжилгээний мэдээлэл авах хүсэлт

MedlinePlus Connect нь LOINC хүсэлтийг хүлээн авахдаа лабораторийн шинжилгээний мэдээлэлтэй нийцдэг. Үйлчилгээ нь хариуг англи эсвэл испани хэлээр өгөх боломжтой.

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 хүчин зүйлийн шинжилгээ

Хэлний болон гаралтын форматын талаархи дэлгэрэнгүй мэдээллийг Output Parameters дээрх хэсгээс үзнэ үү.

Лабораторийн шинжилгээний хүсэлтийн дагуу сонгосон атомын элементүүд (эсвэл JSON объектууд) -ын тодорхойлолт

Элемент	Тодорхойлолт
гарчиг	Тохирсон MedlinePlus лабораторийн туршилтын хуудасны гарчиг
холбоос	Тохирсон MedlinePlus лабораторийн туршилтын хуудасны URL
хураангуй	Хуудасны агуулгаас авсан хэсэг
зохиогч	Лабораторийн туршилтын агуулгын эх сурвалж

Лабораторийн шинжилгээний хүсэлтийн жишээ

Англи хэлээр ярьдаг хүнээс мэдээлэл хүсэхийн тулд таны хүсэлт дараахь зүйлсийн аль нэгтэй төстэй байж болно: 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&informationRecip. = en

Испани хэлээр яригчтай холбоотой мэдээлэл хүсэхийн тулд таны хүсэлт дараахь зүйлсийн аль нэгтэй төстэй байж болно: 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&informationRecip. = es

Зөвшөөрөгдсөн хэрэглээний бодлого

MedlinePlus серверүүдийг хэт ачаалахгүйн тулд NLM нь MedlinePlus Connect-ийн хэрэглэгчид нэг IP хаяг тутамд минут тутамд 100-аас илүүгүй хүсэлт илгээхийг шаарддаг. Энэ хязгаараас хэтэрсэн хүсэлтэд үйлчилгээ үзүүлэхгүй бөгөөд 300 секундын дараа эсвэл хүсэлтийн хэмжээ хязгаарын доор орох хүртэл, аль нь дараа нь ирсэн тохиолдолд үйлчилгээг сэргээхгүй. Connect руу илгээсэн хүсэлтүүдийн тоог хязгаарлахын тулд NLM нь үр дүнг 12-24 цагийн турш кэшлэхийг зөвлөж байна.

Энэхүү бодлого нь үйлчилгээг бүх хэрэглэгчдэд хүртээмжтэй, хүртээмжтэй байлгах үүднээс хэрэгжүүлж байна. Хэрэв танд MedlinePlus Connect руу олон тооны хүсэлт илгээхийг шаардсан тодорхой хэрэглээний тохиолдол байгаа тул энэ журамд заасан хүсэлтийн хувь хэмжээнээс хэтэрсэн бол бидэнтэй холбоо барина уу. NLM-ийн ажилтнууд таны хүсэлтийг үнэлж, онцгой тохиолдол гарах эсэхийг тодорхойлох болно. MedlinePlus XML файлын баримтыг үзнэ үү. Эдгээр XML файлууд нь эрүүл мэндийн сэдвүүдийн бүрэн бүртгэлийг агуулдаг бөгөөд MedlinePlus-ийн өгөгдөлд хандах өөр аргыг ашиглаж болно.

Нэмэлт мэдээлэл