MedlinePlus Connect: บริการเว็บ
เนื้อหา
- ภาพรวมบริการเว็บ
- พารามิเตอร์เอาต์พุต
- คำขอวินิจฉัย (ปัญหา) รหัส
- พารามิเตอร์เสริม
- คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ JSON) ในการตอบสนองต่อคำขอรหัสปัญหา
- ตัวอย่างคำขอรหัสปัญหา
- บริการและไฟล์ที่เกี่ยวข้อง
- ขอข้อมูลยา
- พารามิเตอร์เสริม
- คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ JSON) ในการตอบสนองต่อคำขอยา
- ตัวอย่างการขอรหัสยา
- คำขอข้อมูลการทดสอบในห้องปฏิบัติการ
- พารามิเตอร์เสริม
- คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ JSON) ในการตอบสนองต่อคำขอทดสอบแล็บ
- ตัวอย่างคำร้องสำหรับการทดสอบในห้องปฏิบัติการ
- นโยบายการใช้งานที่ยอมรับได้
- ข้อมูลมากกว่านี้
MedlinePlus Connect มีให้บริการในรูปแบบเว็บแอปพลิเคชันหรือบริการบนเว็บ ด้านล่างนี้คือรายละเอียดทางเทคนิคสำหรับการใช้บริการเว็บ ซึ่งตอบสนองต่อคำขอตาม:
คุณสามารถเชื่อมโยงและแสดงข้อมูลที่ส่งคืนโดย MedlinePlus Connect คุณไม่สามารถคัดลอกหน้า MedlinePlus ลงในไซต์ของคุณได้ หากคุณใช้ข้อมูลจาก MedlinePlus Connect Web Service โปรดระบุว่าข้อมูลนั้นมาจาก MedlinePlus.gov แต่อย่าใช้โลโก้ MedlinePlus หรือบอกเป็นนัยว่า MedlinePlus รับรองผลิตภัณฑ์เฉพาะของคุณ โปรดดูหน้า API ของ NLM สำหรับคำแนะนำเพิ่มเติม สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเชื่อมโยงไปยังเนื้อหา MedlinePlus นอกบริการนี้ โปรดดูหลักเกณฑ์และคำแนะนำในการเชื่อมโยงของเรา
หากคุณตัดสินใจใช้ MedlinePlus Connect ให้ลงชื่อสมัครใช้รายชื่ออีเมลเพื่อติดตามการพัฒนาและแลกเปลี่ยนความคิดเห็นกับเพื่อนร่วมงานของคุณ โปรดแจ้งให้เราทราบหากคุณใช้ MedlinePlus Connect โดยติดต่อเรา
ภาพรวมบริการเว็บ
พารามิเตอร์สำหรับคำขอบริการเว็บสอดคล้องกับ HL7 Context-Aware Knowledge Retrieval (ปุ่มข้อมูล) คำขอความรู้ URL-Based Implementation Guide การตอบสนองตาม REST เป็นไปตาม HL7 Context-Aware Knowledge Retrieval (ปุ่มข้อมูล) Service-Oriented Architecture Implementation Guide ผลลัพธ์ของคำขออาจเป็น XML ในรูปแบบฟีด Atom, 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 โดยที่ CallbackFunction คือชื่อที่คุณตั้งให้ฟังก์ชันโทรกลับ
- สำหรับการตอบกลับใน XML ให้ใช้:
- KnowledgeResponseType=text/xml หรือปล่อยพารามิเตอร์ knowledgeResponseType ออกจากคำขอ
คำขอวินิจฉัย (ปัญหา) รหัส
สำหรับรหัสปัญหา MedlinePlus Connect จะส่งคืนลิงก์และข้อมูลจากหน้าหัวข้อสุขภาพของ MedlinePlus หน้าพันธุศาสตร์หรือหน้าจากสถาบัน NIH อื่น ๆ
MedlinePlus Connect จะส่งคืนสิ่งต่อไปนี้:
โค้ดแต่ละโค้ดอาจไม่ตรงกันเสมอไป ในกรณีเหล่านี้ MedlinePlus Connect จะตอบกลับเป็นโมฆะ
URL พื้นฐานของบริการคือ: https://connect.medlineplus.gov/service
มีสองพารามิเตอร์ที่จำเป็นสำหรับการสืบค้นใดๆ สำหรับบริการนี้:
- ระบบรหัส
ระบุระบบรหัสปัญหาที่คุณจะใช้- สำหรับ 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
- รหัส
ระบุรหัสจริงที่คุณพยายามค้นหา:
mainSearchCriteria.v.c=250.33
พารามิเตอร์เสริม
ชื่อรหัส
คุณอาจระบุชื่อ/ชื่อของรหัสปัญหาได้ อย่างไรก็ตาม ข้อมูลนี้ไม่ส่งผลกระทบต่อการตอบสนอง (ต่างจากเว็บแอปพลิเคชัน MedlinePlus Connect ที่อาจใช้ข้อมูลชื่อ/ชื่อเรื่อง) mainSearchCriteria.v.dn=เบาหวานที่มีอาการโคม่าประเภท 1 อื่นที่ไม่สามารถควบคุมได้ ดูส่วนด้านบนในพารามิเตอร์เอาต์พุตสำหรับรายละเอียดเกี่ยวกับภาษาและรูปแบบเอาต์พุต
คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ 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=Diabetes%20mellitus%20with%20other%20coma%20type%201%20uncontrolled&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
ผู้ป่วยที่วินิจฉัยว่าเป็น "ปอดบวมจากเชื้อ Pseudomonas" โดยใช้รหัส SNOMED CT 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= โรคปอดบวม%20due%20to%20Pseudomonas%20%28ความผิดปกติ%29&informationRecipient.languageCode.c=th
ผู้ป่วยที่มีการวินิจฉัยเดียวกันแต่รูปแบบที่ร้องขอคือ JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFunction
บริการและไฟล์ที่เกี่ยวข้อง
หากต้องการรับหัวข้อสุขภาพของ MedlinePlus ในการตอบสนองต่อคำขอข้อความ ให้ตรวจสอบบริการเว็บ MedlinePlus ตรงข้ามกับรหัสปัญหา นอกจากนี้ หากคุณต้องการชุดหัวข้อสุขภาพ MedlinePlus ทั้งหมดในรูปแบบ XML โปรดดูหน้าไฟล์ XML ของเรา
ขอข้อมูลยา
MedlinePlus Connect ให้ข้อมูลยาที่ดีที่สุดเมื่อได้รับ RXCUI นอกจากนี้ยังให้ผลลัพธ์ที่ดีเมื่อได้รับรหัส NDC MedlinePlus Connect สามารถตอบกลับเป็นภาษาอังกฤษหรือสเปน
สำหรับคำขอข้อมูลยาภาษาอังกฤษ หากคุณไม่ส่ง NDC หรือ RXCUI หรือหากเราไม่พบข้อมูลที่ตรงกันตามรหัส แอปพลิเคชันจะใช้สตริงข้อความที่คุณส่งเพื่อแสดงการจับคู่ข้อมูลยาที่ดีที่สุด สำหรับคำขอข้อมูลยาของสเปน MedlinePlus Connect จะตอบกลับเฉพาะ NDC หรือ RXCUI และไม่ใช้สตริงข้อความ เป็นไปได้ที่จะมีการตอบกลับเป็นภาษาอังกฤษ แต่ไม่มีคำตอบเป็นภาษาสเปน
บริการเว็บ MedlinePlus Connect จะส่งคืนสิ่งต่อไปนี้:
อาจมีการตอบสนองต่อคำขอยาเพียงครั้งเดียว คำขอแต่ละรายการอาจไม่ตรงกันเสมอไป ในกรณีเหล่านี้ MedlinePlus Connect จะตอบกลับเป็นโมฆะ
สำหรับการขอข้อมูลยา URL พื้นฐานคือ: https://connect.medlineplus.gov/service
หากต้องการส่งคำขอ ให้ระบุข้อมูลเหล่านี้:
- ระบบรหัส
ระบุประเภทของรหัสยาที่คุณกำลังส่ง (จำเป็นสำหรับภาษาอังกฤษและสเปน)- สำหรับ RXCUI ใช้:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.88
- สำหรับการใช้งาน NDC:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.69
- รหัส
ระบุรหัสจริงที่คุณพยายามค้นหา (เหมาะสำหรับภาษาอังกฤษ จำเป็นสำหรับภาษาสเปน)
mainSearchCriteria.v.c=637188 - ชื่อยา
ระบุชื่อยาด้วยสตริงข้อความ (ไม่บังคับสำหรับภาษาอังกฤษ ไม่ได้ใช้สำหรับภาษาสเปน)
mainSearchCriteria.v.dn=Chantix 0.5 MG ยาเม็ดรับประทาน
พารามิเตอร์เสริม
ชื่อรหัสเมื่อส่งคำขอข้อมูลภาษาอังกฤษ คุณอาจใส่พารามิเตอร์ทางเลือกของชื่อยา ซึ่งมีรายละเอียดอยู่ในส่วนข้างต้น mainSearchCriteria.v.dn=Chantix 0.5 MG ยาเม็ดรับประทาน
ดูส่วนด้านบนในพารามิเตอร์เอาต์พุตสำหรับรายละเอียดเกี่ยวกับภาษาและรูปแบบเอาต์พุต
คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ JSON) ในการตอบสนองต่อคำขอยา
ธาตุ | คำอธิบาย |
---|---|
หัวข้อ | ชื่อเรื่องสำหรับหน้ายา MedlinePlus ที่ตรงกัน |
ลิงค์ | URL สำหรับหน้ายา MedlinePlus ที่ตรงกัน |
ผู้เขียน | ที่มาของข้อมูลยา |
ตัวอย่างการขอรหัสยา
คำขอข้อมูลยาของคุณควรมีลักษณะดังนี้
หากต้องการขอข้อมูลโดย 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
หากต้องการขอข้อมูลโดย 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 รู้ว่าคุณกำลังค้นหาข้อมูลยา สิ่งนี้จะใช้ได้สำหรับคำขอภาษาอังกฤษเท่านั้น คำขอของคุณอาจมีลักษณะดังนี้: 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.c =en
คำขอข้อมูลการทดสอบในห้องปฏิบัติการ
MedlinePlus Connect ให้ข้อมูลการแข่งขันในห้องปฏิบัติการเมื่อได้รับคำขอ LOINC บริการสามารถตอบกลับเป็นภาษาอังกฤษหรือสเปน
บริการเว็บ MedlinePlus Connect จะส่งคืนสิ่งต่อไปนี้:
โค้ดแต่ละโค้ดอาจไม่ตรงกันเสมอไป ในกรณีเหล่านี้ MedlinePlus Connect จะตอบกลับเป็นโมฆะ
URL พื้นฐานของบริการคือ: https://connect.medlineplus.gov/service
นี่เป็นพารามิเตอร์ที่จำเป็นสองประการสำหรับการสืบค้นการทดสอบในห้องปฏิบัติการสำหรับบริการนี้:
- ระบบรหัส
- ระบุว่าคุณกำลังใช้ระบบรหัส LOINC ใช้:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.1
- MedlinePlus Connect จะยอมรับ:
- mainSearchCriteria.v.cs=2.16.840.1.113883.11.79
- รหัส
ระบุรหัสจริงที่คุณพยายามค้นหา:
mainSearchCriteria.v.c=3187-2
พารามิเตอร์เสริม
ชื่อรหัสคุณอาจระบุชื่อการทดสอบในห้องปฏิบัติการได้ อย่างไรก็ตาม ข้อมูลนี้ไม่ส่งผลกระทบต่อการตอบสนอง mainSearchCriteria.v.dn=การทดสอบปัจจัยทรงเครื่อง
ดูส่วนด้านบนในพารามิเตอร์เอาต์พุตสำหรับรายละเอียดเกี่ยวกับภาษาและรูปแบบเอาต์พุต
คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ 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.dn=Factor%20IX%20assay&informationRecipient.languageCode.c=th https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =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&informationRecipient.languageCode.c =es
นโยบายการใช้งานที่ยอมรับได้
เพื่อหลีกเลี่ยงไม่ให้เซิร์ฟเวอร์ MedlinePlus ทำงานหนักเกินไป NLM กำหนดให้ผู้ใช้ MedlinePlus Connect ส่งคำขอไม่เกิน 100 รายการต่อนาทีต่อที่อยู่ IP คำขอที่เกินขีดจำกัดนี้จะไม่ได้รับการบริการ และบริการจะไม่ถูกเรียกคืนเป็นเวลา 300 วินาที หรือจนกว่าอัตราคำขอจะต่ำกว่าขีดจำกัด แล้วแต่ว่าจะถึงอย่างใดในภายหลัง เพื่อจำกัดจำนวนคำขอที่คุณส่งไปยัง Connect NLM แนะนำให้แคชผลลัพธ์เป็นระยะเวลา 12-24 ชั่วโมง
นโยบายนี้มีขึ้นเพื่อให้แน่ใจว่าบริการจะยังคงใช้งานได้และผู้ใช้ทุกคนสามารถเข้าถึงได้ หากคุณมีกรณีการใช้งานเฉพาะที่ต้องการให้คุณส่งคำขอจำนวนมากไปยัง MedlinePlus Connect และทำให้เกินอัตราคำขอที่ระบุไว้ในนโยบายนี้ โปรดติดต่อเรา เจ้าหน้าที่ NLM จะประเมินคำขอของคุณและพิจารณาว่าอาจมีการยกเว้นหรือไม่ โปรดตรวจสอบเอกสารประกอบไฟล์ MedlinePlus XML ไฟล์ XML เหล่านี้มีบันทึกหัวข้อด้านสุขภาพที่สมบูรณ์ และสามารถทำหน้าที่เป็นวิธีอื่นในการเข้าถึงข้อมูล MedlinePlus