הגרסה הלא אמינה של מבחן דוא"ל היא קצרה: יצירת כתובת, השהייה של חמש שניות, קריאת ההודעה הראשונה, וקוות שהיא שייכת להרצה זו.
הגרסה האמינה עדיין פשוטה, אך היא מתייחסת למסירה כאל אסינכרונית. היא יוצרת כתובת ייחודית, רושמת זמן התחלה, מבצעת פולינג עד לתאריך יעד, מתאמת את ההודעה המתאימה, מאמתת את הפעולה במוצר, ומדווחת על הקשר מספיק כאשר משהו נכשל.
שמרו על מפתח ה‑API מחוץ ל‑URL
שלחו את מפתח GPTMail בכותרת X-API-Key. אל תציבו אותו בפרמטרי השאילתה ?api_key=. כתובות URL נשמרות באופן שגרתי בהיסטוריית הדפדפן, יומני גישה, מערכות ניטור ונתוני הפניות.
X-API-Key: YOUR_API_KEYאחסנו את המפתח במנהל הסודות של ה‑CI שלכם והסתרו אותו ביומנים. מפתח ציבורי יומי נוח לחקירה; חבילות אוטומציה מבוקרות צריכות להשתמש במפתח שהקצאתו ושימושו ניתנים למעקב.
הקצות והדוגמאות לתגובות מתוחזקות בעמוד תיעוד API של GPTMail.
כתובת אחת לכל הרצה
צור כתובת חדשה עבור כל מבחן שניתן להריץ באופן עצמאי. אל תסיקו נכונות מתיבת דואר משותפת לכל חבילת המבחנים.
רשמו את הכתובת, מזהה הסצנה, הסביבה, וזמן תחילת המבחן. ערכים אלה מאפשרים לדחות הודעות ישנות ולאבחן התנגשויות מבלי לתעד סודות של הודעות.
פולינג עד לתאריך יעד, לא השהייה קבועה
זמן המסירה של דוא"ל משתנה. השהייה קבועה של חמש שניות מבזבזת משאבים כאשר המסירה מהירה וגורמת לתקלות כאשר היא איטית.
השתמשו בלולאה מוגבלת:
deadline = now + 90 seconds
delay = 2 seconds
while now < deadline:
messages = list inbox
candidate = newest message matching sender, subject, and start time
if candidate exists:
read candidate and continue the product test
wait delay with a small random jitter
delay = min(delay * 1.5, 10 seconds)תאריך היעד הוא חלק מהחוזה של המבחן. זרימת איפוס סיסמה עשויה לדרוש מגבלה שונה מהצפייה בתצוגה מקדימה של ניוזלטר גורף. שמרו על המגבלה מפורשת כדי שתלות איטית לא תמתח בשקט את כל משימת ה‑CI.
התאמה מדויקת
„הודעה ראשונה בתיבת הדואר“ אינה בחירה שימושית. התאימו מספר איתותים:
- הנמען שווה לכתובת שנוצרה עבור הרצה זו;
- זמן היצירה מאוחר מזמן ההפעלה;
- השולח שייך לשירות הצפוי;
- הנושא או סוג ההודעה תואמים לזרימה;
- מזהה ההודעה עדיין לא נצרך.
כאשר השולח יכול להוציא מספר קודים, בחרו את ההודעה החדשה ביותר שתואמת. שמרו את מזהה ההודעה בפלט המבחן כדי שהפעלות חוזרות לא ישתמשו בו בטעות.
קריאה רק לאחר התאמת רשימה
רשימת תיבת הדואר צריכה להיות שלב הגילוי הזול. שלפו את ההודעה המלאה רק עבור המועמד שנבחר. זה מצמצם עבודה מיותרת ומונע ניתוח דואר פרסומי שאינו קשור.
אמתו את תוצאת העסק, ולא רק את קיומו של מחרוזת של שישה ספרות. שלחו את הקוד או פתחו את הקישור הצפוי, ואז וודאו שהחשבון מגיע למצב הנכון.
טיפול במגבלות קצב כאות
אם ה‑API מחזיר תגובת מכסה או מגבלת קצב, עצרו את הניסיון הנוכחי והציגו את מידע האיפוס. ניסיונות חוזרים אגרסיביים הופכים אות קיבולת ברור לרעש ויכולים לעכב מבחנים שאינם קשורים.
הגבילו קונקורנטיות ברץ המבחנים, במיוחד כאשר חבילה יוצרת מספר רב של כתובות בבת אחת. בריכת עובדים קטנה קלה יותר לאיתור באגים מאשר מאות לולאות פולינג במקביל.
ניקוי ללא הסתרת תקלות
ניקוי צריך לרוץ לאחר תיעוד הראיות. בהצלחה, מחקו הודעות או תנו לשמירה קצרה לטפל בהן. בכשל, שמרו את הכתובת ומזהה ההודעה בארטיפקטים מוגנים של ה‑CI זמן מספיק לחקירה, ואז מחקו אותם.
לעולם אל תדפיסו קודי אימות, קישורים פרטיים, או גופי HTML שלמים ביומני בנייה ציבוריים.
הפיכת ניסיונות חוזרים לאידמפוטנטיים
בצעו ניסיון חוזר של המבחן כהרצה חדשה עם כתובת חדשה. אל תניחו שחזרה על אותה בקשה נגד אותו חשבון ותיבת דואר מתחילה ממצב נקי. השולח עשוי לבטל קודים ישנים, להגביל בקשות חוזרות, או לדחות הזמנות כפולות.
אם בקשת רשת מתפוגגת, הבדילו בין „לא התקבלה תגובה“ ל‑„הפעולה לא התרחשה“. בדקו את המצב הנצפה לפני ביצוע ניסיון חוזר הרסני.
דיווח על נקודת הכשל
כשל אוטומציה שימושי מזה אחד מהשלבים הבאים:
- יצירת הכתובת נכשלה;
- פעולת המוצר נכשלה לפני תור הדוא"ל;
- לא הגיעה הודעה תואמת לפני תאריך היעד;
- ההודעה הגיעה אך התוכן לא תואם;
- פעולת האימות נכשלה;
- הניקוי נכשל.
סיווג זה הופך את ה„מבחן דוא"ל נכשל“ האינטרמיטנטי לעבודה שהצוות יכול לקחת על עצמו.
למטריצה הרחבה יותר של המבחנים, קראו את תוכנית מבחן דוא"ל אמיתית. לאבחון מסירה, השתמשו ב-דוא"ל אימות שלא מגיע: מצאו את הצעד השבור.