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

มีสองพารามิเตอร์ที่จำเป็นสำหรับการสืบค้นใดๆ สำหรับบริการนี้:

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) ในการตอบสนองต่อคำขอรหัสปัญหา

ตัวอย่างคำขอรหัสปัญหา

คำขอฉบับสมบูรณ์สำหรับผู้ป่วยโรคเบาหวานด้วยอาการโคม่าประเภท 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

หากต้องการส่งคำขอ ให้ระบุข้อมูลเหล่านี้:

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=Chantix 0.5 MG ยาเม็ดรับประทาน

พารามิเตอร์เสริม

เมื่อส่งคำขอข้อมูลภาษาอังกฤษ คุณอาจใส่พารามิเตอร์ทางเลือกของชื่อยา ซึ่งมีรายละเอียดอยู่ในส่วนข้างต้น mainSearchCriteria.v.dn=Chantix 0.5 MG ยาเม็ดรับประทาน

ดูส่วนด้านบนในพารามิเตอร์เอาต์พุตสำหรับรายละเอียดเกี่ยวกับภาษาและรูปแบบเอาต์พุต

คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ JSON) ในการตอบสนองต่อคำขอยา

ตัวอย่างการขอรหัสยา

คำขอข้อมูลยาของคุณควรมีลักษณะดังนี้

หากต้องการขอข้อมูลโดย 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

นี่เป็นพารามิเตอร์ที่จำเป็นสองประการสำหรับการสืบค้นการทดสอบในห้องปฏิบัติการสำหรับบริการนี้:

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=การทดสอบปัจจัยทรงเครื่อง

ดูส่วนด้านบนในพารามิเตอร์เอาต์พุตสำหรับรายละเอียดเกี่ยวกับภาษาและรูปแบบเอาต์พุต

คำอธิบายขององค์ประกอบอะตอมที่เลือก (หรือวัตถุ JSON) ในการตอบสนองต่อคำขอทดสอบแล็บ

ตัวอย่างคำร้องสำหรับการทดสอบในห้องปฏิบัติการ

หากต้องการขอข้อมูลสำหรับผู้พูดภาษาอังกฤษ คำขอของคุณอาจมีลักษณะดังนี้: 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

ข้อมูลมากกว่านี้