Webhooks בקטע "אווטארים של וידאו": הודעה לשרת שלך כשהסרטון מוכן
Webhooks בקטע "אווטרים של וידאו" היא דרך לגלות שהסרטון מוכן, מבלי לרענן את העמוד באופן ידני: ברגע שהסרטון הושלם, נשלחת בקשת POST לכתובת השרת שלך, והשרת שלך בעצמו מחליט מה לעשות הלאה - כתוב את הקישור למסד הנתונים, שלח את הקובץ ללקוח, או התחל בשלב הבא. הלשונית נחוצה למי שעושה סרטונים באצווה או משלבים את יצירת האווטרים במוצר שלהם: במקום בדיקות אינסופיות של "מוכן או עדיין לא", הודעה קצרה אחת מגיעה בדיוק ברגע הנכון.
למה זה בכלל נחוץ?
עיבוד סרטון אינו פעולה מיידית, ואין טעם לחכות לו בלשונית פתוחה. על פי מדידות פלטפורמה מתאריך 09/07/2026, סרטון קלינג 3.0 באורך חמש שניות ב-1080p נחשב לממוצע של 115 שניות, וב-95% מהמקרים הוא מתאים ל-165. עבור Sora 2, אותה משימה אורכת בממוצע כ-145 שניות. אם אתה בודק את הסטטוס כל כמה שניות, עשרות בקשות ריקות מופיעות בסרטון אחד; ה-webhook מגיע רק פעם אחת - כאשר התוצאה מופיעה בפועל.
גם הכרך מדבר בעד עצמו. על פי יומן הדור של הפלטפורמה, במשך 30 יום (3 בספטמבר - 2 באוקטובר 2026), החלו 3,292 משימות וידאו, מתוכן 2,369 הושלמו בהצלחה. הסרטונים נספרים ברקע ומסתיימים בזמנים שונים - לא ניתן לעקוב אחר זה באופן ידני, ומטפל הודעות מסודר פותר את הבעיה בעצמו.
מה עושה הכרטיסייה "Webhooks"?
זה הכל על שליחת התראות, ללא קסם. אתה רושם כתובת, בוחר לאילו אירועים להירשם ומקבל סוד מנוי. רשימת נקודות הקצה הרשומות מאוחסנת ממש שם: אתה יכול לראות את הכתובת, האירועים שנבחרו, הסטטוס והאם לנקודת הקצה יש סוד. ניתן לשחרר מחדש את הסוד (הישן יפסיק מיד לעבוד) או שניתן למחוק את נקודת הקצה לחלוטין.
האירוע מגיע רק מהסרטונים שלך: הסרטון של מישהו אחר לא ייצא, גם אם הוא נספר באותו רגע. יש גם יומן של אירועים שנמסרו - זה נוח לבדוק שמשהו באמת הגיע לשרת שלך.
איך מתחילים - צעד אחר צעד
- פתח קטע "אווטרים של וידאו" ופאנל webhook בכתובת ישירה /ru/avatars?tab=webhooks.
- היכנס לחשבון שלך: ההגדרה אינה זמינה לאורחים; כאשר לוחצים עליו, ייפתח חלון התחברות.
- בשדה "כתובת נקודת קצה", הזן את כתובת ה-HTTPS הציבורית של השרת שלך, לדוגמה https://example.com/avatar-webhook. HTTP לא יעבוד - מסירה וחתימה מיועדות לערוץ מאובטח.
- סמן את האירועים הנדרשים. אם לא תבחר שום דבר, תהיה מנוי לכל האירועים בבת אחת.
- לחץ על "הוסף נקודת קצה". מיד לאחר היצירה יופיע סוד המנוי - העתק ושמור לעצמך: הוא לא יוצג שוב.
- אם עדיין אין לך שרת משלך, לחץ על "החלף את המקלט שלנו" - אז הודעות יצטברו ביומן האירועים שנמסרו ישירות בכרטיסייה.
איך לוודא שהבקשה היא מאיתנו ולא מזויפת
כל בקשה מלווה בכותרת חתימה - זהו HMAC-SHA256, המחושב מהגוף הגולמי של הבקשה כסוד שלך. בצד שלך, ספר את אותה חתימה והשווה: אם היא לא תואמת, אנו פוסלים את הבקשה. המקלט שלנו עושה בדיוק את זה ומגיב ב-401 לחתימה שגויה. שמור את הסוד בשרת, במשתני סביבה, ולא בקוד הלקוח.
מה בא בבקשה
הגוף הוא JSON רגיל עם סוג האירוע ונתוני הישות. לדוגמה, עבור סרטון גמור, זהו אירוע BLK0 עם מזהה הסרטון בתוכו. הרשימה המלאה של סוגי האירועים הזמינים מוצגת בלשונית: אתה יכול למיין אותה ולהשאיר רק את מה שהשירות שלך באמת צריך.
כמה זה עולה
רישום נקודות קצה, שחרור סודי מחדש, מחיקה ויומן אירועים אינם מוחקים אסימונים - זוהי הגדרת התראה, לא יצירת. אסימונים מוציאים רק על הסרטון עצמו: המחיר באסימונים נראה לפני ההשקה, ואם המשימה נכשלת, מה שנכתב מוחזר. אין מנוי: משתמשים חדשים מקבלים אסימוני התחלה עבור הבדיקות הראשונות שלהם.
עם מה לשלב
- "משימות אצווה" - השקת עשרות סרטונים עם משימה אחת; Webhook יבטל את הצורך בבקרת מוכנות ידנית.
- "ספריית מדיה" - אחסון של קודי מקור וקבצים מוגמרים.
- "תרגום וידאו" ו "חיתוך קליפ" - הצעדים הבאים אחרי דור.
שאלות נפוצות
איזו כתובת מתאימה ל-webhook?
HTTPS ציבורי בלבד. כתובות מקומיות ו-HTTP אינם מתקבלים: ההתראה חייבת לעבור בערוץ מאובטח, והשרת שלך חייב להיות נגיש מבחוץ.
האם ניתן לקבל התראות אם אין שרת?
כֵּן. לחץ על "החלף את המקלט שלנו" - האירועים יצטברו ביומן "אירועים שנמסרו" בלשונית, ניתן לצפות בהם ללא ה-backend שלך.
מה לעשות אם החתימה לא תואמת?
בדוק שאתה קורא את HMAC-SHA256 מגוף הבקשה הגולמית (ולא מה-JSON המנתח) ושאתה משתמש בסוד הנוכחי: לאחר הנפקה מחדש, הישן מפסיק מיד לעבוד.
זה בתשלום?
הגדרת webhooks לא מוחקת אסימונים. אסימונים מושקעים רק ביצירת וידאו - המחיר שלהם נראה לפני ההשקה; אין מנוי, משתמשים חדשים מקבלים אסימוני התחלה.