StreamLive Pro

מה זה Webhook? כתובת ברשת שמקבלת הודעות

מה זה Webhook: כתובת פרטית ברשת שמקבלת הודעה כשמשהו קורה. Webhook נכנס ב-Discord וב-Slack, ‏Webhook יוצא לאירועים, ואיך שומרים עליהם.

עודכן · 4 דק׳ קריאה

Webhook היא כתובת ברשת שמחכה להודעות. במקום שאפליקציה אחת תשאל שוב ושוב אפליקציה אחרת "קרה משהו?", האפליקציה השנייה שולחת הודעה קצרה לכתובת ה-Webhook ברגע שמשהו קורה. הכתובת בדרך כלל ארוכה ואקראית, וכל מי שמכיר אותה יכול לשלוח אליה. לכן מתייחסים לכתובת Webhook כמו לסיסמה.

ל-Webhook יש שני כיוונים, וכדאי להפריד ביניהם:

דוגמאות מהיומיום

Webhook פועל בשקט מאחורי הרבה דברים שאתם כבר משתמשים בהם. לדוגמה:

בכל המקרים האלה אף אחד לא לוחץ על כפתור כדי להעביר את הידיעה הלאה. המערכת הראשונה יודעת שמשהו קרה, ומודיעה לשנייה מיד.

Webhook מול האפשרויות האחרות

גישהאיך זה עובדמתאים ל
Webhookהשירות שולח הודעה לכתובת שלכם כשמשהו קורהתגובה מיידית, מעט תעבורה
בדיקה חוזרת (polling)המערכת שלכם שואלת את השירות כל כמה דקותמערכות פשוטות שבהן עיכוב לא מפריע
קריאת APIהמערכת שלכם מבקשת משהו מסוים כשהיא צריכהקריאת נתונים, ביצוע פעולות
חיבור OAuthאפליקציה פועלת בחשבון שלכם באישורכםחיבורים מלאים, כמו פרסום ב-YouTube. ראו מה זה OAuth? חיבור חשבון בלי למסור סיסמה

איך נראית הודעת Webhook

הודעת Webhook היא בקשת רשת רגילה, בדרך כלל עם קטע טקסט קטן בפורמט JSON:


POST https://example.com/hooks/streamlive
Content-Type: application/json

{"event": "stream.started", "data": {"stream_id": "...", "title": "Weekly class"}}

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

Webhook ב-StreamLive Pro

1. פרסום ל-Discord ול-Slack (Webhook נכנס). שתי הרשתות האלה מתחברות דרך Webhook ולא דרך התחברות. יוצרים Webhook לערוץ אחד ב-Discord או ב-Slack, מדביקים את הכתובת שלו בעמוד חיבורים, והערוץ הופך ליעד בעמוד פרסום לכל הרשתות. כשמחברים Discord, הכתובת נבדקת קודם מול Discord. חיבור Slack לא שולח שום דבר לערוץ. Discord מקבל טקסט וקובץ אחד. Slack מקבל טקסט וקישורים, אבל לא קבצים. צעד אחר צעד: פרסום לערוץ Discord או Slack דרך Webhook.

מסך החיבורים (חשבון בדיקה).
מסך החיבורים (חשבון בדיקה).

2. Webhook לאירועים (יוצא), במסלול Studio. בהגדרות, בחלק "API ו-Webhooks", יש כרטיס Webhooks: מקלידים כתובת https, מסמנים את האירועים הרצויים ולוחצים "הוסף webhook". מאותו רגע StreamLive Pro שולחת POST לכתובת בכל אירוע שסימנתם, חתום ב-HMAC-SHA256. סוד החתימה מוצג פעם אחת בלבד, מיד אחרי ההוספה, אז מעתיקים אותו מיד. באותו כרטיס רואים את רשימת ה-Webhooks ואפשר למחוק אותם. במסלולים אחרים החלק מסביר ש-Webhooks כלולים ב-Studio: /pricing.

אירוענשלח כש
stream.startedשידור מתחיל
stream.endedשידור מסתיים, עם האורך שלו
payment.succeededתשלום של החשבון עובר
subscription.canceledהמנוי מבוטל
destination.disconnectedבאמצע שידור, בדיקת התקינות שלנו (בערך פעם בדקה) מגלה שהשידור לאחד הערוצים נכשל, ומתחילה לחבר אותו מחדש. לא מסומן מראש

שלושת הראשונים מסומנים כברירת מחדל. כל אירוע נשלח פעם אחת, בלי ניסיון חוזר, ו-Webhook שנכשל 20 פעמים ברצף נכבה. כללים שמגינים עליכם: הכתובת חייבת להיות https ולהצביע לשרת ציבורי, לא לשרת פנימי; עד 10 לחשבון; הפניות (redirects) לא נעקבות. מפתחות API נמצאים באותו חלק: מפתחות API למפתחים: יצירה, שימוש וביטול.

Webhook או בדיקה חוזרת (Polling)

‏Webhook דוחף אליכם הודעה ברגע שמשהו קורה. בדיקה חוזרת היא הכיוון ההפוך: המערכת שלכם שואלת את השירות כל כמה דקות אם משהו השתנה. בדיקה חוזרת פשוטה יותר להקמה, לא דורשת כתובת ציבורית אצלכם, ושום דבר לא הולך לאיבוד אם השרת שלכם היה למטה לזמן מה, כי פשוט שואלים שוב. המחיר הוא עיכוב ויותר בקשות. ‏Webhook מיידי ושקט, אבל השרת שלכם חייב להיות זמין, לענות מהר ולהתמודד עם הודעה שמגיעה פעמיים או לא מגיעה בכלל, ולכן מערכות זהירות בודקות גם מדי פעם כדי לתפוס מה שפוספס. עם StreamLive Pro אפשר את שניהם: Webhooks לאירועים במסלול Studio, וה-API לכל מה שרוצים לשאול בקצב שלכם.

איך שומרים על Webhook

  1. מתייחסים לכתובת כסוד. כל מי שיש לו כתובת של Webhook נכנס יכול לפרסם בערוץ שלכם. לא מדביקים אותה בצ'אטים פתוחים, בצילומי מסך או במסמכים משותפים.
  2. Webhook אחד לכל מטרה. אם אחד דולף, מוחקים רק אותו.
  3. מוחקים ויוצרים מחדש Webhook שדלף. ב-Discord וב-Slack אפשר למחוק Webhook וליצור חדש. אחר כך מדביקים את הכתובת החדשה בעמוד חיבורים.
  4. בשרת שלכם בודקים את החתימה. דוחים הודעות שהחתימה שלהן לא מתאימה, ועונים מהר. עבודה ארוכה עושים אחרי התשובה.
  5. מצפים לכפילויות ולחורים. בונים את הצד המקבל כך שקבלה כפולה של אותו אירוע לא תזיק.

לפני שיוצרים Webhook

  1. מחליטים איזה ערוץ יקבל את הפוסטים. Webhook שייך לערוץ אחד. ערוץ שני צריך Webhook משלו.
  2. בודקים שיש לכם הרשאה. ב-Discord זו ניהול השילובים של הערוץ, וב-Slack הוספת אפליקציה לסביבת העבודה. אם האפשרות לא מופיעה, מבקשים מהמנהל.
  3. נותנים ל-Webhook שם ברור, למשל "פוסטים מ-StreamLive Pro", כדי שגם בעוד שנה המנהל ידע מה זה.
  4. מדביקים אותו פעם אחת, ולא משתפים אותו הלאה.

בעיות נפוצות

בעיהסיבה סבירהפתרון
פוסטים הפסיקו להגיע לערוץ ב-Discord או ב-Slackה-Webhook נמחק או שהערוץ הוסריוצרים Webhook חדש ומדביקים אותו שוב
Discord דוחה את הכתובתזו לא כתובת Webhook מלאה של Discordמעתיקים את כל הכתובת. היא מתחילה ב-https://discord.com/api/webhooks/
קובץ לא הגיע ל-SlackWebhook של Slack לא מקבל קבציםמפרסמים קישור לסרטון במקום
השרת שלכם לא מקבל כלוםהכתובת לא https, לא ציבורית, או מפנה הלאהמשתמשים בכתובת https ציבורית שעונה ישירות

שאלות נפוצות

מה זה Webhook במילים פשוטות?

כתובת פרטית ברשת שמקבלת הודעה באופן אוטומטי כשמשהו קורה, כך שאף אחד לא צריך לבדוק כל הזמן.

כתובת Webhook היא סודית?

כן. כל מי שיש לו כתובת של Webhook נכנס יכול לפרסם בערוץ. שומרים עליה ומוחקים אותה אם היא דלפה.

איך מפרסמים מ-StreamLive Pro ל-Discord?

יוצרים Webhook בהגדרות הערוץ ב-Discord, מדביקים את הכתובת בעמוד חיבורים, ובוחרים את הערוץ כשמפרסמים.

StreamLive Pro יכולה להודיע למערכת שלי כששידור מתחיל?

כן, במסלול Studio: בהגדרות, בחלק "API ו-Webhooks", מוסיפים כתובת https עם האירוע stream.started. ההודעות חתומות בסוד שמוצג פעם אחת, כך שהשרת שלכם יכול לבדוק שהן הגיעו מ-StreamLive Pro.

המשך קריאה

מה זה OAuth? חיבור חשבון בלי למסור סיסמה

מה זה OAuth: הדרך שבה אפליקציה אחת מקבלת גישה מוגבלת לחשבון שלכם בשירות אחר, בלי הסיסמה. מה זה טוקן ומה זו הרשאה, למה חיבורים פגים ואיך מבטלים.

קריאה ל-API של StreamLive Pro נכשלת: קודי שגיאה ופתרונות

שגיאות ה-API של StreamLive Pro בהסבר פשוט: מפתח לא תקין או שפג, הרשאה חסרה, מגבלת מסלול, 409, 429 ו-5xx, וגם קודי המפתחות הישנים באותיות גדולות.

מגבלות קצב ב-API, ניסיונות חוזרים ו-Idempotency-Key

מגבלות הקצב של ה-API של StreamLive Pro לכל מפתח, לכל חשבון, לכתיבה ולפרסום; כותרות RateLimit, מה עושים ב-429, וניסיון חוזר בטוח עם Idempotency-Key.

מה ChatGPT ו-Claude לא יכולים לעשות ב-StreamLive Pro

הגבולות של ChatGPT ו-Claude ב-StreamLive Pro, עם הסיבה לכל אחד ומה עושים במקום: חיבור רשתות, פוסטים לטיקטוק, העלאות, אישורים ועוד.

רוצים לנסות? 7 ימי ניסיון, בלי כרטיס אשראי.

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