מדריך קודי סטטוס HTTP בחינם

בשימוש לבקשות עם Expect: 100-continue. השרת מאשר שהוא מוכן לקבל את הגוף לפני שהלקוח שולח אותו. נראה לעתים רחוקות ביישומי אינטרנט מודרניים.

בשימוש הנפוץ ביותר לשדרוגי WebSocket - הלקוח מבקש Upgrade: websocket והשרת משיב ב-101 כדי לעבור.

תגובת ביניים של WebDAV שנשלחת כדי למנוע פסקי זמן (timeout) בצד הלקוח במהלך פעולות ארוכות. הוצא משימוש - שרתים מודרניים לא צריכים לשלוח אותה.

מאפשר לשרתים לשלוח כותרות Link (preload/preconnect) בזמן שהתגובה הסופית עדיין מתכוננת, כדי שדפדפנים יוכלו להתחיל להביא נכסים קריטיים מוקדם יותר.

תגובת ההצלחה הסטנדרטית. המשמעות תלויה בשיטת HTTP: GET → משאב מוחזר, POST/PUT → הפעולה הושלמה.

נפוץ לאחר POST. התגובה צריכה לכלול כותרת Location המצביעה על ה-URL של המשאב החדש.

לפעולות אסינכרוניות - השרת מסדר את העבודה בתור. הלקוח צריך לשאול נקודת קצה של סטטוס או לחזור מאוחר יותר.

הבקשה הצליחה, אך גורם ביניים (כגון proxy למטמון או להמרה) שינה את התוכן שהגיע מהשרת המקורי - לדוגמה, דחיסת תמונות מחדש. נדיר בפועל.

בשימוש לעתים קרובות לפעולות DELETE או עדכוני PUT שלא צריכים להחזיר גוף. הלקוח לא צריך לנווט מהדף הנוכחי.

כמו 204, לא מוחזר גוף - אך הלקוח מונחה בנוסף לאפס את הטופס או התצוגה שיצרו את הבקשה (לדוגמה, לנקות את שדות הטופס עבור הערך הבא).

תגובה לבקשת Range. בשימוש על ידי נגני וידאו ומנהלי הורדות לחידוש הורדות שנקטעו או להזרמת קבצים גדולים.

WebDAV: גוף XML מדווח על תוצאת מספר פעולות משנה בנפרד - לדוגמה, העברה קבוצתית שבה חלק מהפריטים הצליחו ואחרים נכשלו.

WebDAV: בשימוש בתוך תגובות Multi-Status 207 כדי להימנע מרישום חוזר של חברי אותו אוסף כאשר קישורי binding יוצרים לולאות.

קידוד דלתה: השרת מחזיר diff מול גרסה קודמת במקום המשאב המלא, תוך חיסכון בפס רוחב. מיושם לעיתים נדירות מאוד.

השרת מציע מספר אפשרויות (לדוגמה, פורמטים או שפות שונות) והלקוח צריך לבחור אחת. בשימוש נדיר, מכיוון שמשא ומתן אוטומטי על תוכן בדרך כלל מטפל בזה.

בשימוש לשינויי URL קבועים - מנועי חיפוש יעדכנו את האינדקס שלהם. סמכות ה-SEO עוברת ל-URL החדש.

מציין שההפניה אינה קבועה. ה-caching פחות אגרסיבי מאשר ב-301. בשימוש למקרים כמו 'נדרשת התחברות, הפניה ל-/login'.

בשימוש לאחר הגשות POST - התגובה אומרת 'ה-POST שלך עבד, ראה את ה-URL של ה-GET הזה לקבלת התוצאה'. דפדפנים תמיד מבצעים GET ל-URL החדש.

תגובה לבקשה מותנית (עם If-None-Match או If-Modified-Since headers). חוסך פס רוחב - אין גוף מוחזר.

אם המקור היה POST, ההפניה משתמשת גם ב-POST. חלופה מודרנית ל-302 כאשר שימור שיטה חשוב.

החלפה מודרנית ל-301 כאשר אתה רוצה שבקשות POST יישארו POST לאחר ההפניה.

סיבות נפוצות: JSON שגוי בגוף, פרמטרי שאילתה לא תקפים, או שדות נדרשים חסרים. בדוק את גוף הבקשה וכותרות.

הלקוח חייב לכלול פרטי אימות (Authorization header, cookie, token). 'Unauthorized' הוא שם מטעה - למעשה הוא מציין 'לא מאומת'.

נועד במקור לתשלומים דיגיטליים. שימוש מודרני: ממשקי API מחזירים לפעמים 402 כשמשתמש חרג מהמכסה ששילם עליה.

שונה מ-401 - המשתמש כן מחובר, אך לחשבון שלו אין הרשאה למשאב זה. בדוק את הלוגיקה של תפקיד/הרשאות.

או שה-URL שגוי, או שהמשאב נמחק, או שהוא מעולם לא היה קיים. שרתים לעתים מחזירים 404 כדי להסתיר את קיומו כאשר 403 היה מדויק יותר.

לדוגמה, בקשת GET לנקודת קצה המקבלת רק POST. התגובה צריכה לכלול כותרת Allow המפרטת שיטות תקפות.

הלקוח ביקש סוג תוכן, שפה או קידוד (דרך Accept, Accept-Language, Accept-Encoding) שהשרת לא יכול לספק. שרתים רבים מדלגים על משא ומתן קפדני ומחזירים ברירת מחדל במקום זאת.

כמו 401, אך הונפקה על ידי proxy: הלקוח חייב לשלוח credentials Proxy-Authorization. נראה בתוך רשתות תאגידיות עם authenticating proxies.

הלקוח לקח זמן רב מדי לשליחת גוף הבקשה או השאיר את החיבור במצב סרק. נסה את הבקשה שוב.

בדרך כלל מוחזר בהתנגשויות עריכה במקביל או בניסיונות ליצור משאבים כפולים (לדוגמה, יצירת משתמש עם דוא"ל שכבר קיים).

חזקה יותר מ-404 — השרת יודע במפורש שהמשאב היה קיים בעבר אך הוסר לצמיתות. מנועי חיפוש יסירו אותו מהאינדקס.

הבקשה נדחתה מכיוון שחסרה לה כותרת Content-Length והשרת מסרב לגופים בגודל לא ידוע. הוסף את הכותרת ונסה שוב.

מוחזר כאשר כותרות מותנות כמו If-Match או If-Unmodified-Since נכשלות — בדרך כלל נעילה אופטימית: מישהו אחר שינה את המשאב מאז הגרסה שלך. טען מחדש את המשאב ונסה שוב.

נפוץ בעת העלאת קבצים גדולים. תצורת השרת (nginx, apache) קבעה גודל גוף מקסימלי. בדוק את תצורת השרת.

בדרך כלל נגרם ממחרוזות שאילתה ארוכות מאוד (לדוגמה, קידוד נתונים בבקשת GET). עבור לגוף POST, או הגדל את מגבלת השרת אם אתה שולט בו.

לדוגמה, שליחת application/xml לשרת שמקבל רק application/json. הגדר את כותרת Content-Type בצורה נכונה.

כותרת ה-Range מבקשת חלק שאין בקובץ — לדוגמה, המשך הורדה מעבר לסוף הקובץ. התגובה צריכה לכלול Content-Range עם הגודל בפועל.

נשלח כאשר השרת אינו תומך ב-Expect: 100-continue. חלק מהלקוחות שולחים כותרת זו כברירת מחדל על POSTs גדולים; השבתה בדרך כלל פותרת את השגיאה.

צחוק יום אפריל מ-1998 (RFC 2324). כמה APIs בפועל משתמשים בו לצחוקים או לסימון נקודות קצה מיושנות. לא לשימוש בייצור.

נפוץ עם שימוש חוזר בחיבור HTTP/2: הבקשה הגיעה לשרת שאינו מוגדר לשם המארח (hostname) של היעד. הלקוח צריך לנסות שוב בחיבור חדש.

לדוגמה, ה-JSON נותח בצורה נכונה אך שדה חובה היה חסר, או שערך שדה היה מחוץ לטווח. נפוץ בתגובות אימות של REST API.

WebDAV: משאב המקור או היעד נעול על ידי לקוח אחר, כך שלא ניתן להמשיך בפעולה. המתן שהנעילה תשוחרר או בטל אותה עם הטוקן הנכון.

WebDAV: בשרשרת של פעולות תלויות, פעולה קודמת נכשלה, ולכן זו לא בוצעה. בדוק את הכשל הקודם כדי למצוא את הסיבה השורשית.

קשור ל-TLS 1.3 0-RTT (נתונים מוקדמים): השרת לא יסתכן בעיבוד בקשה שאולי נשלחה שוב (replay). הלקוח צריך לנסות שוב לאחר השלמת לחיצת היד (handshake).

השרת מסרב לשרת את הבקשה על פני הפרוטוקול הנוכחי אך יעשה זאת לאחר שדרוג — התגובה כוללת כותרת Upgrade שקובעת את הפרוטוקול הנדרש.

השרת דורש כותרות מותנות (כמו If-Match) כדי למנוע קונפליקטים של אובדן עדכונים. הבא את המשאב, לכוד את ה-ETag שלו, ושלח מחדש עם If-Match.

האט. התגובה צריכה לכלול כותרת Retry-After המציינת מתי לנסות שוב. נפוץ עם APIs שיש להם מכסות בקשה.

או שכותרת אחת או הגודל הכולל של הכותרות חורג מהמגבלה — לרוב נגרם מעוגיות גדולות מדי. נקה עוגיות או הפחת מה שהאפליקציה שלך מאחסנת בהן.

המשאב חסום מסיבות משפטיות — צנזורה, צווי בית משפט, או תקנות אזוריות. המספר הוא קריצה לרומן Fahrenheit 451.

לכידה כללית לשגיאות בצד השרת. בדוק יומנים של השרת עבור הסיבה בפועל: חריגה לא מטופלת, שגיאת בסיס נתונים וכו'.

לדוגמה, השרת לא מזהה את שיטת HTTP. נדיר בפועל — לעתים קרובות יותר תראה 405.

נפוץ בארכיטקטורות ממיקרוסרביס. מאזן העומס או הפרוקסי ההפוך שלך קיבל תגובה מעוותת מהשירות הקצה האחורי.

או שהשרת מושבת לתחזוקה או שהוא בעומס יתר. התגובה צריכה לכלול כותרת Retry-After. לעתים קרובות מוחזר במהלך פריסות.

שירות הקצה האחורי לא הגיב במהירות מספקת. בדוק את תקינות שירות ה-upstream ואת הגדרות ה-timeout.

גרסת ה-HTTP הראשית של הבקשה אינה נתמכת על ידי השרת. כמעט לא נראה עם לקוחות מודרניים.

משא ומתן שקוף על תוכן הסתיים בלולאה: הווריאנט שנבחר מוגדר בעצמו לנהל משא ומתן. מצביע על שגיאת תצורה בשרת.

WebDAV-ספציפי במקורו אך לפעמים משמש שרתים כלליים. פירושו שהשרת לא יכול לשמור את הבקשה בגלל אילוצי אחסון.

WebDAV: עיבוד בקשת Depth: infinity נכנס ללולאה (לדוגמה, קישורים מעגליים). הפעולה הופסקה.

מ-HTTP Extension Framework המיושן: השרת צריך מידע נוסף לפני שהוא יכול לעמוד בבקשה. למעשה לא משמש ברשת המודרנית.

משמש על ידי פורטלים שבויים (בית מלון / WiFi שדה תעופה) כדי להצביע על כך שהמשתמש חייב להתחבר לרשת לפני גישה לאתרים חיצוניים.