Web Debugger

מטרת המערכת וכוונת המשתמש: זיהוי ואבחון אינטראקציות API אינטרנטיות על ידי בניית בקשות HTTP, אימות התשובות וזיהוי חריגות. קהל היעד כולל מהנדסי frontend, מפתחי backend, אנליסטים QA וצוותי API שדורשים בדיקות שניתן לשכפל בסביבות שונות, אבחון נקודות קצה מפוקפקות או אימות אינטגרציות עם שירותים חיצוניים. הערך המרכזי הוא בכניסות מסודרות, פלטים מדויקים והשוואות דטרמיניסטיות שמפחיתות את זמן הדיבוג.
הליבה והפונקציות: ניהול כניסות רב-שדות באמצעות טפסים עבור base_url, נתיב endpoint, שיטה, כותרות, פרמטרים של שאילתא וגוף אופציונלי. תכונות עיקריות כוללות בניית בקשה, ביצוע, לכידת תגובה, מדידת זמן-סיבוב ואימות מצב/כותרות/גוף. תכונות מתקדמות כוללות משתני סביבה, שגרות אימות, תבניות מוכנות מראש, diffing לפי JSON-path וייצוא תוצאות.
כניסות ותוצאות: כניסות כוללות base_url (מחרוזת, נדרש), endpoint (מחרוזת, נדרש), metode (GET/POST/PUT/PATCH/DELETE, נדרש), headers (אובייקט, אפשרי), query_params (אובייקט, אפשרי), body (מחרוזת, אפשרי), expected_status (מספר, אפשרי), expected_headers (אובייקט, אפשרי), ו-expected_body_pattern (מחרוזת, אפשרי). תוצאות כוללות actual_status (מספר), actual_headers (אובייקט), actual_body (מחרוזת), latency_ms (מספר) ו-diffs (מערך של מחרוזות). כללי עיצוב: גופים ב-JSON משווים כאשר Content-Type הוא application/json; אחרת diff סטרינג-ביט. השוואות מספריות מדויקות אלא אם מוגדרת סובלנות.
אלגוריתמים וחישובים: בניית URL מתוך base_url ו-endpoint, מיזוג כותרות, הצמדת פרמטרי שאילתה ושליחת בקשת HTTP. מדוד את זמן מעגל-המסירה לחישוב latency_ms. אם התשובה JSON, בצע השוואה מובנית ל-expected_body_pattern או נתיבי JSON ממוקדים; אחרת יישם Diff טקסטואלי. סמן חפיפות עבור מצב, כותרות או תוכן גוף ויצר רשימת diff תמציתית עם התייחסות נתיב-השדה.
שגיאות ו-Marginalia: מטפל בקלטים לא תקינים (לדוגמה, URL חסרה, שיטה לא נתמכת), שגיאות רשת, זמני-מתנה ותשובות לא-דטרמיניסטיות. מחזיר כותרות רגישות, דורש UTF-8 ומחזיר קודי שגיאה תקניים עם הנחיות retry אפשריות. עומסי payload גדולים או תשובות streaming מוגבלים; כאשר נתונים חיצוניים אינם זמינים או שיש מגבלות קצב, מוחזרים תוצאות חלקיות וקודי שגיאה.