לדלג לתוכן הראשי

טריגר Webhook ואימות הבקשה

בחרו יעד שהוגדר מראש ובדקו את הבקשה במערכת המקבלת.

נכתב על ידי Alex Merkin

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

טריגר Webhook משתמש ברשומת Webhook שהוגדרה מראש. הוא אינו עורך חופשי לבקשות HTTP.

הכנת היעד

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

טופס יצירת Webhook עם שם, קישור, מודל, אירועים ופעיל

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

שיוך לשלב

  1. בחרו שלב ופתחו טריגרים.

  2. הוסיפו טריגר ובחרו את אירוע השלב.

  3. בחרו בפעולה Webhook ובחרו את הרשומה הנכונה.

  4. הוסיפו תנאי אם הקריאה נדרשת רק בחלק מהמקרים.

  5. שמרו, בדקו במאמת ובצעו בדיקה בסשן אמיתי מבוקר.

הבורר מציג את הרשומות ואת מצבן הפעיל או הלא פעיל. בחרו את היעד הפעיל המיועד.

מה נשלח

המנגנון שולח POST עם תוכן JSON שהמערכת מייצרת וכותרת Content-Type: application/json. התוכן כולל פרטי model, trigger ו־data. בטריגר התהליך אין פקדים לבחירת GET/PUT/PATCH, להזנת גוף בקשה חופשי או לכותרות אימות מותאמות. אין להניח ששילוב משתנים בכתובת או בגוף הבקשה נתמך שם.

אימות מול היעד

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

וידוא מסירה

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


האם קיבלת תשובה לשאלתך?