Skip to content

קודי מצב HTTP מוסברים

כל קוד מצב תגובה נפוץ של HTTP, מקובץ לפי מחלקה: מה הוא אומר ומתי תיתקלו בו. טבלת העיון המהירה שמלווה את הכלי קודי מצב HTTP.

לכל קודי המצב של HTTP יש תבנית אחת: הספרה הראשונה מציינת את המחלקה, והשאר פירוט.‏ 1xx פירושו מידע, 2xx פירושו הצלחה, 3xx פירושו הפניה, 4xx פירושו שגיאת לקוח, ו-5xx פירושו כשל שרת. קראו קודם את הספרה הראשונה. הכלי המלווה מאפשר לחקור קוד בודד לעומק.

טבלת עיון · 55 ערכיםOpen the http-status-codes tool →
55 of 55 rows
1xx מידע
Continueהשרת קיבל את כותרות הבקשה והלקוח רשאי לשלוח את הגוף.אחרי בדיקה מקדימה לפני העלאת גוף גדול.
Switching Protocolsהשרת מסכים לעבור לפרוטוקול שהלקוח ביקש.שדרוג חיבור HTTP ל-WebSocket.
Processingהשרת קיבל את הבקשה ועדיין עובד עליה.שרת WebDAV שמאשר קבלת בקשה ארוכה כדי שהלקוח לא יפוג מעצמו.
Early Hintsהשרת שולח כותרות ראשוניות לפני שהתשובה הסופית מוכנה.מתן אפשרות לדפדפן לטעון מראש נכסים בזמן שהעמוד עדיין ברינדור.
2xx הצלחה
OKהבקשה הצליחה וגוף התשובה נושא את התוצאה.הצלחה סטנדרטית ל-GET או ל-PUT.
Createdהבקשה הצליחה ונוצר משאב חדש.מוחזר אחרי POST מוצלח שיוצר משהו.
Acceptedהבקשה התקבלה לעיבוד אך עדיין לא הסתיימה.עבודה ארוכה החלה ורצה באופן אסינכרוני.
Non-Authoritative Informationהבקשה הצליחה אך הנתונים שהוחזרו שונו בדרך חזרה.פרוקסי או מטמון שמגיש מטא-דאטה ששונה במקום זה של המקור.
No Contentהבקשה הצליחה ואין גוף להחזיר.‏DELETE הצליח, או PUT שאין לה מה לומר.
Reset Contentהבקשה הצליחה והלקוח אמור לאפס את התצוגה ששלחה אותה.אחרי שליחת טופס, כדי לבקש מהעמוד לפנות את שדותיו.
Partial Contentהשרת מחזיר רק חלק מהמשאב, כפי שנתבקש.הגשת טווח בתים מבקשת Range.
3xx הפניה
Moved Permanentlyלמשאב יש URL חדש קבוע ובקשות עתידיות צריכות להשתמש בו.עמוד עבר ומנועי החיפוש חייבים לעדכן את האינדקס שלהם.
Foundהמשאב נמצא זמנית ב-URL אחר, אבל המשיכו להשתמש במקורי.הפניה זמנית לעמוד התחברות.
See Otherהתשובה נמצאת ב-URL אחר ויש לאחזר אותה ב-GET.תבנית PRG: הפניית POST לעמוד תוצאה כדי שרענון לא ישלח את הטופס שוב.
Not Modifiedהעותק במטמון עדיין תקף, ולכן השרת לא שולח גוף.GET מותנה שבו המטמון של הלקוח מעודכן.
Use Proxyאת הבקשה יש לשלוח דרך הפרוקסי שנקבע בתשובה.רשתות פרוקסי מיושנות; לא בשימוש מאז 2011.
Temporary Redirectהמשאב נמצא זמנית במקום אחר ויש לשמר את שיטת הבקשה המקורית.כמו 302, אבל POST נשאר POST בהפניה.
Permanent Redirectלמשאב URL חדש קבוע ויש לשמר את שיטת הבקשה המקורית.כמו 301, אבל POST נשאר POST בהפניה.
4xx שגיאת לקוח
Bad Requestהשרת לא הבין את הבקשה בגלל תחביר שגוי.JSON שבור, או שדה חובה חסר.
Unauthorizedנדרש אימות זהות, והוא היה חסר או נכשל.אין טוקן, או טוקן שגוי או פג תוקף.
Payment Requiredהבקשה דורשת תשלום, אם כי המפרט מעולם לא הגדיר איך.חלק מה-API משתמשים בו כסמן לחומת תשלום; רובם לעולם לא.
Forbiddenהלקוח מאומת אך אסור לו לגשת למשאב הזה.התחברות תקפה, אבל אין הרשאה למשאב הזה.
Not Foundאין לשרת משאב בכתובת ה-URL הזו.URL לא מוכר או מזהה שלא קיים.
Method Not Allowedה-URL קיים אבל לא מאפשר את שיטת הבקשה שנעשה בה שימוש.POST לנקודת קצה שמקבלת רק GET.
Not Acceptableהשרת לא יכול להחזיר תוכן שתואם לכותרות Accept של הלקוח.הלקוח ביקש רק XML, אבל ה-API מחזיר רק JSON.
Proxy Authentication Requiredהלקוח חייב להתאמת מול הפרוקסי לפני שהבקשה ממשיכה הלאה.פרוקסי ארגוני שדוחה בקשה לא מאומתת.
Request Timeoutללקוח לקח יותר מדי זמן לשלוח את הבקשה והשרת ויתר.העלאה שנתקעה לפני שהגוף הספיק להגיע.
Conflictהבקשה מתנגשת עם המצב הנוכחי של המשאב.כתובת דואר כפולה או מרוץ עריכה על אותה רשומה.
Goneהמשאב היה קיים פעם אך הוסר לצמיתות.נקודת קצה שהוצאה משימוש בכוונה, חזק מ-404.
Length Requiredהבקשה צריכה כותרת Content-Length ואין לה.שרת שחייב לדעת את הגודל מראש דוחה גוף בסטרימינג.
Precondition Failedתנאי קדם בכותרת, כמו If-Match, הוערך כשקר.עריכה אופטימית שבה הרשומה השתנתה מאז שהלקוח קרא אותה.
Content Too Largeגוף הבקשה חורג מהמגבלה שהשרת מקבל.העלאה גדולה מגודל הגוף המרבי של השרת.
URI Too Longה-URL של הבקשה ארוך מכפי שהשרת מוכן לפרש.טופס שנכנס בטעות למחרוזת שאילתת GET שגדלה בלי גבול.
Unsupported Media Typeפורמט גוף הבקשה אינו אחד מהפורמטים שנקודת הקצה מקבלת.POST עם Content-Type text/plain לנקודת קצה של JSON בלבד.
Range Not Satisfiableטווח הבתים בכותרת Range לא מתאים למשאב.בקשת בתים מעבר לסוף קובץ בזמן חידוש הורדה.
Expectation Failedהשרת לא יכול לעמוד בציפייה שנקבעה בכותרת Expect.ציפיית 100-continue שהשרת מסרב לקיים.
I'm a teapotהשרת הוא קנקן תה ומסרב לחלוט קפה.מתיחת אחד באפריל מ-1998 שלא מתה; API מחזירים אותה לשעשוע.
Misdirected Requestהבקשה נשלחה לשרת שלא יכול לייצר לה תשובה.חיבור ממוחזר שנשלח למארח שהשרת הזה לא משרת.
Unprocessable Entityהבקשה תקינה מבחינת מבנה אך הערכים שלה נכשלים באימות סמנטי.JSON תקין שהשדות שלו מפרים כללי עסק.
Too Earlyהשרת דוחה בקשה שיש סיכון שהיא השמעה חוזרת.דחיית בקשה שאינה אידמפוטנטית שנוסתה שוב לפני רוטציית מפתחות.
Upgrade Requiredהלקוח חייב לעבור לפרוטוקול אחר כדי להשתמש במשאב הזה.נקודת קצה שמתעקשת על TLS או WebSocket.
Precondition Requiredהשרת דורש כותרות מותנות שהבקשה לא שלחה.API שדורש If-Match כדי למנוע עדכונים אבודים.
Too Many Requestsהלקוח שלח יותר מדי בקשות בחלון זמן נתון.הגעה למגבלת קצב; האטו ונסו שוב.
Request Header Fields Too Largeשדה כותרת אחד או יותר גדול מכפי שהשרת מסוגל לעבד.קובץ cookie או טוקן שגדל עד שחסם כל בקשה לאתר.
Unavailable For Legal Reasonsהמשאב חסום מטעמים משפטיים, כמו צו הסרה או הגבלה גיאוגרפית.צו הסרה ממשלתי או עמוד שנחסם במדינה אחת.
5xx שגיאת שרת
Internal Server Errorהשרת נתקל במצב בלתי צפוי ונכשל.חריגה לא מטופלת או באג בשרת.
Not Implementedהשרת לא תומך בשיטה או בתכונה שנתבקשו.נקודת קצה שהוגדרה אך עדיין לא נבנתה.
Bad Gatewayשעת גישה או פרוקסי קיבלו תשובה שגויה משרת מקור.פרוקסי הפוך שלא הצליח להגיע לבקאנד.
Service Unavailableהשרת אינו מסוגל באופן זמני לטפל בבקשה.תחזוקה, עומס יתר, או שירות תלוי שמושבת.
Gateway Timeoutשעת גישה או פרוקסי לא קיבלו תשובה בזמן משרת מקור.הבקאנד לקח יותר מדי זמן והפרוקסי ויתר.
HTTP Version Not Supportedהשרת לא תומך בגרסת ה-HTTP שבבקשה.לקוח שמדבר בגרסת פרוטוקול שהשרת מעולם לא למד.
Variant Also Negotiatesמשא ומתן תוכן שקוף הסתיים בהפניה מעגלית.שרת שהוגדר בטעות שמבצע משא ומתן תוכן ניסיוני.
Insufficient Storageהשרת לא יכול לאחסן את הייצוג הדרוש להשלמת הבקשה.שרת WebDAV שהאחסון שהוקצה לו מלא.
Loop Detectedהשרת נקלע ללולאה אינסופית בעיבוד הבקשה.קישור WebDAV שמפנה לעצמו.
Network Authentication Requiredהלקוח חייב להתאמת מול הרשת כדי לקבל גישה.פורטל כלוא במלון או בשדה תעופה שמיירט את הבקשה.