MedlinePlus Connect: שירות אינטרנט

תוֹכֶן

• סקירה כללית על שירות האינטרנט
• פרמטרי פלט
• בקשות לאבחון קודי (בעיה)
• פרמטרים אופציונליים
• תיאור של רכיבי אטום נבחרים (או אובייקטים JSON) בתגובה לבקשות קוד הבעיה
• דוגמאות לבקשות לקודי בעיה
• שירותים וקבצים קשורים
• בקשות למידע על תרופות
• פרמטרים אופציונליים
• תיאור של אלמנטים אטומים נבחרים (או אובייקטים JSON) בתגובה לבקשות התרופות
• דוגמאות לבקשות לקודי סמים
• בקשות למידע על בדיקת מעבדה
• פרמטרים אופציונליים
• תיאור של רכיבי אטום נבחרים (או אובייקטים JSON) בתגובה לבקשות בדיקת מעבדה
• דוגמאות לבקשות לבדיקות מעבדה
• מדיניות שימוש מקובלת
• עוד מידע

MedlinePlus Connect זמין כיישום אינטרנט או כשירות אינטרנט. להלן הפרטים הטכניים ליישום שירות האינטרנט, אשר עונה לבקשות על בסיס:

אתם מוזמנים לקשר ולהציג את הנתונים שהוחזרו על ידי MedlinePlus Connect. אינך רשאי להעתיק דפי MedlinePlus לאתר שלך. אם אתה משתמש בנתונים משירות האינטרנט MedlinePlus Connect, אנא ציין שהמידע הוא מ- MedlinePlus.gov אך אל תשתמש בלוגו של MedlinePlus או לרמוז אחרת כי MedlinePlus תומך במוצר הספציפי שלך. אנא עיין בדף ה- API של NLM להנחיות נוספות. לקבלת מידע נוסף אודות קישור לתוכן MedlinePlus מחוץ לשירות זה, עיין בהנחיות ובהוראות לקישור.

אם תחליט להשתמש ב- MedlinePlus Connect, הירשם לרשימת הדוא"ל כדי להתעדכן בהתפתחויות ולהחליף רעיונות עם עמיתיך. אנא ספר לנו אם אתה מיישם את MedlinePlus Connect על ידי פנייה אלינו.

סקירה כללית על שירות האינטרנט

הפרמטרים לבקשות שירות האינטרנט תואמות את מדריך היישום מבוסס HL7 Context Aware Knowledge (Infobutton). התגובה המבוססת על REST תואמת את המדריך ליישום אדריכלות מוכוון שירות HL7 Context Aware Knowledge (Infobutton). הפלט של הבקשה יכול להיות 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 = he

פוּרמָט
זהה אם ברצונך שפורמט התגובה יהיה XML, JSON או JSONP. ברירת המחדל היא XML.

כדי לבקש JSON, השתמש ב:

knowledgeResponseType = יישום / json

עבור JSONP, השתמש ב:

knowledgeResponseType = application / javascript & callback = CallbackFunction כאשר CallbackFunction הוא שם שאתה נותן לפונקציה להתקשרות חזרה.

לתגובה ב- XML, השתמש ב:

knowledgeResponseType = text / xml או השאר את הפרמטר knowResponseType מחוץ לבקשה.

בקשות לאבחון קודי (בעיה)

לקבלת קוד בעיה, MedlinePlus Connect יחזיר קישורים ומידע מדפי נושא הבריאות של MedlinePlus, דפי גנטיקה או דפים ממכוני NIH אחרים.

MedlinePlus Connect יחזיר את הדברים הבאים:

לא תמיד תהיה התאמה לכל קוד. במקרים אלה, MedlinePlus Connect יחזיר תגובה אפסית.

כתובת האתר הבסיסית של השירות היא: 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
סיכום		הסיכום המלא לנושא הבריאות. זה כולל קישורים משובצים לנושאי בריאות רלוונטיים אחרים וכל עיצוב, כולל תבליטים וריווח בין פסקאות. הסיכום הוא ב- HTML. עבור דפי GHR, החלק הראשון של העמוד המלא מסופק.
סיכום		מילים נרדפות לנושא. אלה מכונים "נקרא גם" בעמוד נושא בריאות. לא בכל הנושאים יש מונחים "נקרא גם".
סיכום		אישור ייחוס לטקסט סיכום, אם רוב הסיכום היה מסוכנות פדרלית אחרת. לא לכל הסיכומים יש ייחוס. טקסט ללא ייחוס מקורי ל- MedlinePlus.
סיכום		קישורים נבחרים המשויכים לנושא. זה כולל את שם הדף, כתובת האתר והארגון המשויך אליו (במידת הצורך). הקישורים מעוצבים ברשימה עם תבליטים. לא בכל הנושאים יש קישורים אלה. מספר הקישורים יכול לנוע בין אפס לעשרות.

דוגמאות לבקשות לקודי בעיה

בקשה מלאה לסוכרת עם סוג תרדמת 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% 20 עם% 20other% 20coma% 20type% 201% 20 uncontrolled & 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=41381004&mainSearchCriteria.v.dn= דלקת ריאות% 20due% 20to% 20 Pseudomonas% 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/javascript&callback=CallbackFallback

שירותים וקבצים קשורים

כדי לקבל נושאי בריאות של 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 מ"ג בעל פה

לכל הפחות עליכם לזהות את מערכת הקודים ואת הקוד, או את מערכת הקוד ואת שם התרופה. שלח את שלושתם לקבלת התוצאות הטובות ביותר לבקשות באנגלית. שלח את מערכת הקוד ואת הקוד לבקשות בספרדית.

פרמטרים אופציונליים

כותרת קוד

בעת שליחת בקשה למידע באנגלית, תוכל לכלול את הפרמטר האופציונלי של שם התרופה. זה מפורט בסעיף לעיל. mainSearchCriteria.v.dn = Chantix 0.5 מ"ג בעל פה

עיין בסעיף לעיל בפרמטרי פלט לקבלת פרטים על פורמטים של שפה ופלט.

תיאור של אלמנטים אטומים נבחרים (או אובייקטים JSON) בתגובה לבקשות התרופות

אֵלֵמֶנט	תיאור
כותרת	כותרת לדף התרופות המותאם של MedlinePlus
קישור	כתובת אתר לדף התרופות המותאם של 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% 20 מג"ג% 20 אוראלי% 20 טבלט ומידע קבלה. שפה קוד. C = he

כדי לבקש מידע על ידי 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 = he

בקשות למידע על בדיקת מעבדה

MedlinePlus Connect מספק התאמות למידע על בדיקות מעבדה בעת קבלת בקשת LOINC. השירות יכול לספק מענה באנגלית או בספרדית.

שירות האינטרנט MedlinePlus Connect יחזיר את הדברים הבאים:

לא תמיד תהיה התאמה לכל קוד. במקרים אלה, MedlinePlus Connect יחזיר תגובה אפסית.

כתובת האתר הבסיסית של השירות היא: 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

עיין בסעיף לעיל בפרמטרי פלט לקבלת פרטים על פורמטים של שפה ופלט.

תיאור של רכיבי אטום נבחרים (או אובייקטים JSON) בתגובה לבקשות בדיקת מעבדה

אֵלֵמֶנט	תיאור
כותרת	כותרת דף הבדיקה המעבדה של MedlinePlus
קישור	כתובת אתר לדף הבדיקה המותאם של מעבדת MedlinePlus
סיכום	קטע מתוכן הדף
מְחַבֵּר	ייחוס המקור לתוכן בדיקת המעבדה

דוגמאות לבקשות לבדיקות מעבדה

כדי לבקש מידע לדובר אנגלית, בקשתך עשויה להראות כמו אחת מהבאות: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = גורם% 20IX% 20 assay & informationRecipient.languageCode.c = he https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = he

כדי לבקש מידע לדובר ספרדית, בקשתך עשויה להיראות כמו אחת מהבאות: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = גורם% 20IX% 20 assay & 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 יעריך את בקשתך ויקבע אם יתכן חריג. אנא עיין גם בתיעוד קבצי ה- XML ​​של MedlinePlus. קבצי XML אלה מכילים רשומות שלמות בנושא הבריאות ויכולים לשמש כשיטה חלופית לגישה לנתוני MedlinePlus.

עוד מידע