התוצאות מוצגות לצורכי מידע בלבד ועשויות להכיל שגיאות. מומלץ לאמת מידע חשוב באופן עצמאי. השימוש בכלי הוא באחריותכם בלבד.
מה הכלי עושה
הכלי מסביר מה המשמעות של קוד תגובה. הקלידו מספר כמו 404 כדי לראות את השם שלו, את המחלקה ותיאור בשורה אחת, או הקלידו חלק משם, כמו timeout או redirect, כדי לקבל רשימה של כל הקודים המתאימים. הדף מכסה את 28 הקודים שנתקלים בהם הכי הרבה בממשקי API ובאתרים אמיתיים.
הספרה הראשונה קובעת את המחלקה: 1xx מידע, 2xx הצלחה, 3xx הפניה, 4xx שגיאת לקוח (משהו לא בסדר בבקשה) ו־5xx שגיאת שרת (הבקשה נראתה תקינה, אבל השרת נכשל). לדעת באיזה צד נמצאת התקלה זה בדרך כלל הצעד הראשון בדיבוג של קריאה שנכשלה.
מתי להשתמש בו
- לקרוא שגיאה ב־DevTools של הדפדפן או בשורת לוג ולהחליט אם הבאג בצד הלקוח או בצד השרת.
- לבחור את הקוד הנכון ל־endpoint חדש ב־API, למשל 201 אחרי יצירת משאב.
- להגדיר הפניות בהעברת אתר ולבחור בין 301, 302, 307 ו־308.
- לטפל נכון בהגבלת קצב (rate limiting): לזהות 429 ולהאט את הבקשות.
דוגמה
קלט
429פלט
429 Too Many Requests
Client Error
The user has sent too many requests in a given time (rate limiting).שאלות על הכלי
מה ההבדל בין 401 ל־403?
401 Unauthorized אומר שהשרת לא יודע מי אתם: פרטי ההזדהות חסרים או לא תקינים, כך שהתחברות עשויה לעזור. 403 Forbidden אומר שהוא יודע מי אתם, אבל אין לכם הרשאה לגשת למשאב.
להשתמש ב־301 או ב־308 להפניה קבועה?
שניהם קבועים ושניהם מעבירים את אותות ה־SEO. 308 מבטיח שהמתודה והגוף יישארו זהים, וזה חשוב לבקשות POST ל־API. להעברה רגילה של דפים, 301 הוא הבחירה המקובלת.
מתי API צריך להחזיר 422 במקום 400?
השתמשו ב־400 כשאי אפשר לנתח את הבקשה בכלל, למשל JSON שבור. השתמשו ב־422 כשהיא מנותחת בהצלחה אבל הערכים נכשלים באימות, למשל תאריך סיום שקודם לתאריך ההתחלה.
מה גורם לשגיאת 502 או 504?
שתיהן מגיעות מ־proxy או מ־gateway שיושבים לפני השרת האמיתי, כמו load balancer או CDN. 502 אומר שהשרת ב־upstream שלח תגובה לא תקינה או סירב לחיבור; 504 אומר שהוא לא ענה בזמן.
האם הכלי חינמי?
כן, השימוש חינמי. בלי הרשמה ובלי אימייל. התוצאה מופיעה בדף הזה.
איך מקבלים את התוצאה?
משתמשים בכלי בדף הזה. התוצאה מופיעה כאן, בלי צורך במשלוח לאימייל.