קודי שגיאה ופתרון בעיות

מדריך מלא לתגובות שגיאה ב-Agent API ואיך לטפל בהן.

קודי סטטוס HTTP

שגיאות רישום

• Invalid email format (400): אימות פורמט אימייל לפני שליחה
• Disposable email (400): שימוש בכתובת אימייל קבועה
• Rate limit (per email) (429): מקסימום בקשה אחת לאימייל ב-24 שעות
• Rate limit (per IP) (429): יותר מדי בקשות מאותו IP
• Rate limit (global) (429): מגבלה מערכתית – לנסות שוב אחרי השהייה
• Missing required field (400): לכלול את כל השדות הנדרשים (למשל operator_email)

שגיאות בדיקת סטטוס

• Registration not found (404): registration_id לא תקין או לא קיים
• Token expired (200, status: "expired"): המפעיל לא אישר תוך 24 שעות – ליצור רישום חדש
• Registration rejected (200, status: "rejected"): המפעיל דחה – ליצור קשר או לנסות אימייל אחר

שגיאות טופס API

• Unauthorized / Invalid API key (401): header Authorization: Bearer sr_live_xxx נדרש; לוודא שהמפתח קיים, לא פג תוקף ולא בוטל
• טופס not found (404): לפנות לתמיכה
• No valid fields to update (400): לכלול לפחות שדה אחד תקף ולא מוגן

שגיאות אימות

• Invalid or expired token (404): להשתמש בטוקן הנכון מהאימייל
• Token has expired (400): לבקש רישום חדש
• Already processed (400): הטוקן כבר נוצל
• Turnstile verification failed (400): להשלים אתגר Turnstile בדף האישור
• סיסמה too short (400): סיסמה של 8+ תווים

שיטות עבודה מומלצות

• Retry עם exponential backoff לשגיאות 429 ו-500
• אימות קלט לפני קריאות API (פורמט אימייל וכו')
• טיפול בכל ערכי status בעת polling: pending_verification, approved, rejected, expired

בעיות נפוצות

• מפתח API לא עובד: לבדוק פורמט (sr_live_ + 64 תווים hex), header Authorization, תוקף (90 יום), סטטוס פעיל
• רישום תקוע ב-pending: המפעיל לא בדק אימייל, או דחה – להמתין או ליצור רישום חדש
• עדכוני טופס לא חלים: לוודא שדות ברשימת המותר, פורמט צבע (6 תווים hex בלי #), אילוצים (אורך כותרת וכו')

נושאים קשורים

• תהליך הרישום
• התאמת טופס
• תחילת עבודה