משאבים · 54
Webhooks: טיפול בחזרות, עיכובים ושחזור
הפיכת הודעה שהתקבלה לאפקט עסקי ייחודי וניתן למעקב, שניתן לשחזר לאחר כישלון.
מעודכן · 3 min
מה מדריך זה עוזר להשיג
- אימות הודעות
- הפרדת קבלה מעיבוד
- מניעת השפעות כפולות
- שחזור אירועים חסומים
בדיקה מהירה
- אילו בתים חתומים?
- מתי קבלה היא עמידה?
- האם שני עובדים יכולים לפעול יחד?
- האם הספק מבטיח הזמנה?
- כיצד ניתן למצוא אירוע שאבד?
שיטה שלב אחר שלב
- 1
קריאת חוזה הספק
סוגי רשומות, גרסה, הקשר חשבון, חתימות, תזמון וכללי ניסיון חוזר. Stripe קובע כי הזמנת מסירה אינה מובטחת ושכפולים עלולים להתרחש; אין להחיל עיכוב ספציפי ל-Stripe על כל API.
תוצר: חוזה ספק מתוארך.
- 2
אימות לפני השפעות
בדיקת חתימות עם הספרייה וגוף הגולמי הנדרש על ידי הספק. הגבל גדלים וסוגים מקובלים. בדיקת חתימות לא חוקיות והקשר חשבון לא צפוי בסביבה מורשית ללא רישום סודות.
תוצר: דחיות ללא השפעות.
- 3
שמירה לפני אישור.
הפרדת קבלה עמידה מעיבוד איטי. אם התור אינו יכול לקבל את האירוע, אל תדווח עליו כנשמר. הצלחה מצביעה על קבלה במסגרת החוזה שלך, לאו דווקא על השלמת הפעולה העסקית.
תוצר: מצבים שהתקבלו, עיבוד, הושלמו וחסומים.
- 4
אכיפת זהות.
הגדרת מפתחות אירועים וזהות אפקט עסקי. בדיקת חזרות בו-זמניות ולא רק אספקה רציפה. בדיקה ראשונית ללא אילוצים אטומיים או נעילה יכולה לאפשר לשני עובדים ליצור את אותו האפקט.
תוצר: הוכחה לייחודיות האפקט.
- 5
טיפול בעיכוב ואי-סדר.
אין להניח שהודעה ישנה מתארת את המצב הנוכחי. התייעץ עם המקור כאשר החוזה מאפשר זאת והחיל מעברים עסקיים מאומתים. שמור אירועים שעדיין לא ניתן לפרש.
תוצר: מעברים ובדיקות סדר הפוך.
- 6
התאמה והפעלה חוזרת
הכנת תור שגיאות עם בעלים, סיבה, ניסיונות וסגירה. שמירה על הגנה מפני כפילויות במהלך הפעלה חוזרת. השוואה תקופתית בין ספק לאפליקציה: שחזור מוצלח אינו מוכיח שלא הוחמצ אירוע.
תוצר: הליך שחזור ודוח אי התאמה.
גליון עבודה לשימוש חוזר
מלאו את התצפיות המאושרות שלכם. שדות אלה הם תבנית עבודה, לא תוצאות שנצפו.
| שדה | מידע לרישום |
|---|---|
| אירוע | ספק, חשבון, מזהה וגרסה |
| קבלה | חתימה מאומתת וחותמת זמן עמידה |
| השפעה | מפתח עסקי, מצב וראיות ייחודיות |
| שחזור | סיבה, ניסיון, בעלים וסגירה |
דוגמה בדיונית
סיטואציה להמחשה
דוגמה בדיונית: שני עובדים מקבלים את אותה הודעת אישור במהלך השחזור.
החלטה וראיות צפויות
אילוץ ייחודי של אפקט עסקי ומצב עסקי מאפשרים אספקה אחת בעוד ששתי האספקות נשארות ניתנות למעקב.
הבחנה בין המנגנונים
| מנגנון | מטרה | אימות או הגבלה |
|---|---|---|
| חתימה | אימות המקור במסגרת החוזה | לא הופך את ההשפעות לייחודיות |
| ביטול כפילויות | זיהוי הודעות חוזרות | בדיקת מקביליות והשפעות עסקיות |
| התאמה | מציאת השמטות והבדלים | מתן שם למקור ולתקופה |
מדדי ניהול
| מדד | מה הוא מודד | פעולה ראשונה |
|---|---|---|
| גיל התור | עיכוב של אירועים שלא הושלמו | בדיקת הישנים ביותר |
| אפקטים כפולים | פעולות עסקיות שחוזרות על עצמן בטעות | תיקון אטומיות |
| פערים במקור/יישום | מצבים חסרים או שונים | התאמה עם ראיות סגירה |
טעויות נפוצות
- ניתוח לפני אימות גוף חתום
- אישור לפני קבלה מתמשכת
- הנחת מסירה שהוזמנה
- בדיקת כפילויות רק באופן רציף
שאלות נפוצות
האם הצלחה ב-HTTP פירושה שהעיבוד הושלם?
זה תלוי בחוזה. עם עיבוד אסינכרוני, זה אמור להעיד על קבלה מתמשכת בעוד שמצב העסק עוקב בנפרד.
האם ניתן להניח אספקה חד פעמית בדיוק?
תכנון לחזרות וכשלים במסגרת החוזה האמיתי, עם השפעות ייחודיות והתאמה.
האם יש לשמור את כל הגוף?
רק בעת הצורך עם גישה ושמירה מתאימות. עקבות מינימליים צריכים לתמוך באבחון ובשחזור ללא שמירת סודות.
הפניות רשמיות
הפניות תומכות בשיטה. התאימו את הבדיקות להקשר שלכם; הן אינן הסמכה. כותרות הפניות ומסמכי המקור המקוריים עשויים להיות בשפה אחרת.
תאריך בדיקת המקורות .
