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

Webhooks

מערכת webhook יוצא עם חתימת HMAC-SHA256, ניסיונות חוזרים, ורישום משלוחים.

מקור: src/webhooks/ הרשאה: MANAGE_NOTIFICATIONS

נקודות קצה

MethodEndpointתיאור
POST/webhooksיצירת webhook
GET/webhooksרשימת webhooks
GET/webhooks/:idפרטי webhook
PATCH/webhooks/:idעדכון webhook
DELETE/webhooks/:idמחיקת webhook
POST/webhooks/:id/testשליחת payload לבדיקה
POST/webhooks/:id/regenerate-secretחידוש סוד חתימה
GET/webhooks/:id/historyהיסטוריית משלוחים

אבטחה

חתימת HMAC-SHA256

כל בקשה יוצאת כוללת header חתימה:

X-Webhook-Signature: sha256=<hmac_hex_digest>
  • סוד נוצר אוטומטית ביצירה דרך crypto.randomBytes()
  • ניתן לחדש ללא מחיקת ה-webhook

מודלים ב-Prisma

  • WebhookEndpoint — URL, סוד, אירועים רשומים, דגל מופעל
  • WebhookLog — רשומות ניסיונות משלוח (סטטוס, קוד תגובה, משך)