חיבורי Notion API
בעזרת ה-API של Notion, תוכל ליצור חיבורים פנימיים מותאמים אישית. חלק מהשותפים שלנו עשויים לדרוש גם אסימון חיבור פנימי כדי ליצור קישור בין הפלטפורמה שלהם לסביבת העבודה שלך ב-Notion - להלן, נדריך אותך כיצד להגדיר זאת.
בקר ב-developer hub שלנו עבור תיעוד, משאבים וכלי ניהול חיבורים.
הערה: בעלי סביבות עבודה מנהלים את כל החיבורים בסביבת עבודה. למידע נוסף כאן →
בסרגל הצד השמאלי שלך, נווט אל
Settingsולאחר מכן לכרטיסייהConnections.רק בעלי סביבת עבודה יוכלו לגשת לכרטיסייה
Connectionsוליצור אינטגרציות. אם אינך מנהל, אנא צור קשר עם מנהל סביבת העבודה שלך או השתמש בסביבת עבודה אחרת.יש ללחוץ על הקישור
Develop your own connectionsבתחתית.My connections ייפתח בדפדפן ברירת המחדל שלך. יש ללחוץ על כפתור
+ New connection.יש לספק
Nameעבור החיבור שלך. באופן אופציונלי, ניתן גם להעלות תמונה לשימוש כ-Logo.יש להשתמש בתפריט הנפתח כדי לציין את
Associated workspaceשישמש לחיבור זה.הערה: ודא שאתה מחובר ל-Notion בדפדפן עם אותו חשבון שבו השתמשת בגרסת שולחן העבודה. אחרת, לא תראה את החשבון וסביבות העבודה הנכונים!
החיבור הפנימי שלך נוסף בהצלחה! כעת תוכל לראות אותו בסביבת העבודה שלך, בתפריט
Settings←Connections.יש ללחוץ על
•••לצד החיבור הפנימי כדי לאחזר את אסימון החיבור הפנימי. תזדקקו לאסימון זה עבור כל אוטומציה או תהליך עבודה מבוססי API שהצוות שלכם יוצר, או כדי לקשר את סביבת העבודה שלכם לפלטפורמות של שותפים מסוימים.
הערה: חיבורים פנימיים הם ספציפיים לסביבת עבודה, לכן כדי לשנות את סביבת העבודה המשויכת, תצטרך ליצור חיבור חדש.
כל החיבורים שנוספו לאחרונה הם פנימיים בתחילה. אם אתם מפתחים העובדים על חיבור ציבורי, יש להשתמש תחילה בהוראות שלעיל כדי ליצור חיבור פנימי.
לאחר מכן, יש לפעול לפי ההוראות ב-developer guide שלנו כדי להמיר אותו לחיבור ציבורי.
במהלך תהליך הגדרת האפליקציה, מפתחים יוכלו לבחור את רמת הגישה הנדרשת מהמשתמש.
יכולות תוכן:
קריאת תוכן בלבד
כתיבת תוכן בלבד
הוספת תוכן
יכולות משתמשים
ללא מידע על משתמשים
קריאת פרטי משתמש (לא כולל כתובת האימייל של המשתמש)
קריאת פרטי משתמש (כולל אימייל)
כאשר משתמשים יתקינו חיבורים, רמת גישה זו תוצג. היא תופיע גם בתפריט שיתוף של כל דף שאליו נוסף החיבור. למידע נוסף על התקנת חיבורים בסביבת עבודה →
Webhooks של חיבורים מאפשרים לחיבורים לנטר ולהגיב לשינויים בסביבת עבודה של Notion בזמן אמת.
כאשר מתרחשים שינויים בדפים או במאגרי ידע המשותפים עם החיבור שלך, Notion שולחת באופן אוטומטי התראות לנקודת הקצה של ה-Webhook שלך, מה שמאפשר לחיבור שלך לעדכן באופן מיידי כלים אחרים, להריץ משימות אוטומטיות או להציג את השינויים האחרונים.
הגדרת Webhooks של חיבורים
להוראות, בקר בתיעוד המפתחים שלנו.
Webhooks של חיבורים אינם תומכים כרגע בהתראות עבור:
שינויי משתמש (כולל שינויים בחברות בסביבת עבודה, עדכוני אימייל/שם ושינויי הרשאות).
שינויים בהגדרות סביבת עבודה ו-מרחב צוות.
עבור סוגים אלה של התראות, השתמש ב-יומן הביקורת במקום.
פעולות Webhook לעומת Webhooks של חיבורים
פעולות Webhook ו-Webhooks של חיבורים חולקים קווי דמיון מסוימים – לשניהם יש טריגרים והם יכולים לשלוח אירועים לשירותי צד שלישי. עם זאת, Webhooks של חיבורים מציעים יכולות רחבות יותר:
הם יכולים לנטר פעילות במספר סביבות עבודה.
הם יכולים לטפל במספר בלתי מוגבל של פעולות.
לעומת זאת, פעולות Webhook מיועדות למקרי שימוש פשוטים יותר ומוגדרות באמצעות אוטומציות של מאגרי ידע עם קבוצה מוגבלת של טריגרים.
