קודי מצב של תגובות HTTP

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

הנחיה תפעולית: תגובה זמנית; המשיכו לשלוח את הגוף רק אם הוא צפוי.

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

הנחיה תפעולית: מעבר ברמת החיבור; אמתו את כותרות Upgrade ו-Connection.

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

הנחיה תפעולית: מצב ביניים של WebDAV; המתינו לתגובה הסופית.

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

הנחיה תפעולית: אופטימיזציה ביניים; חייבת להגיע אחריה תגובה סופית.

הבקשה הצליחה. הייצוג תלוי בשיטה: GET מחזירה את המשאב, HEAD מחזירה מטא-נתונים ללא גוף ופעולת כתיבה עשויה להחזיר ייצוג של התוצאה.

הנחיה תפעולית: השתמשו בבקשה שהושלמה כאשר מתאים להחזיר ייצוג בתגובה.

הבקשה הושלמה ויצרה משאב אחד או יותר. על התגובה לזהות את המשאב החדש, בדרך כלל באמצעות Location, והיא עשויה להחזיר את הייצוג שלו.

הנחיה תפעולית: נפוץ לאחר POST או PUT; ודאו שאפשר לאתר את המשאב שנוצר.

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

הנחיה תפעולית: ספקו כתובת URL של הפעולה או מצבה, או דרך אחרת לברר את התוצאה הסופית.

שרת proxy או מתווך ששינה את התגובה החזיר מטא-נתונים או תוכן השונים מתגובת המקור. הדבר מציין שהתגובה אינה ייצוג סמכותי ישיר.

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

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

הנחיה תפעולית: אין לכלול גוף תגובה.

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

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

השרת מילא בקשת טווח תקפה ומחזיר רק את טווח הבתים שהתבקש. Content-Range מתאר את הנתונים שסופקו.

הנחיה תפעולית: ודאו שערכי Range ו-Content-Range תואמים; נפוץ בהורדות ובמדיה שניתן לחדש.

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

הנחיה תפעולית: פרשו את התוצאה של כל משאב שמופיע בפנים; קוד המצב החיצוני לבדו אינו מתאר את התוצאה המלאה.

תגובת multistatus של WebDAV משמיטה פריטים שכבר הופיעו קודם באותה תגובה כדי למנוע כפילות.

הנחיה תפעולית: ייחודי ל-WebDAV; יש לפרש יחד עם תגובת ה-multistatus שסביבו.

השרת מילא בקשת GET באמצעות מניפולציות מופע ומחזיר ייצוג שנגזר מהמשאב הנוכחי לפי מנגנון delta שנקבע במשא ומתן.

הנחיה תפעולית: קידוד delta ייעודי; על הלקוחות והשרתים להסכים על השינוי.

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

הנחיה תפעולית: הציגו חלופות ברורות; אל תניחו שכל לקוח יבחר אוטומטית.

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

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

המשאב זמין זמנית ב-URI אחר. התנהגות היסטורית מאפשרת שינוי שיטה במקרים מסוימים, לכן זו אינה הבחירה הבטוחה ביותר כאשר POST חייב להישאר POST.

הנחיה תפעולית: השתמשו במעבר זמני כאשר שינוי שיטה מקובל; שקלו 307 כאשר אינו מקובל.

על הלקוח להביא את המשאב שצוין ב-Location באמצעות GET (או HEAD לפי העניין), במקום לחזור על הפעולה המקורית. נפוץ לאחר שליחת טופס.

הנחיה תפעולית: מממש את דפוס Post/Redirect/Get ומונע שליחה חוזרת של הפעולה.

בקשת GET או HEAD מותנית מציינת שהייצוג שבמטמון עדיין עדכני. לתגובה אין גוף והיא מאפשרת ללקוח להשתמש בעותק השמור.

הנחיה תפעולית: החזירו רק כאשר מאמת כגון If-None-Match או If-Modified-Since תואם.

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

הנחיה תפעולית: אין לפרוס; הגדירו שרתי proxy בערוץ נפרד.

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

הנחיה תפעולית: אין לשלוח אותו.

המשאב נמצא זמנית ב-URI אחר, ועל הלקוח לשמר את השיטה ואת גוף הבקשה המקוריים בעת מעקב אחר ההפניה.

הנחיה תפעולית: השתמשו כאשר מעבר זמני אינו אמור להמיר POST ל-GET.

המשאב עבר לצמיתות, ועל הלקוח לשמר את השיטה ואת הגוף המקוריים בעת מעקב אחר ההפניה.

הנחיה תפעולית: השתמשו במעבר קבוע כשחשוב לשמר את השיטה; עדכנו הפניות canonical ופנימיות.

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

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

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

הנחיה תפעולית: שלחו פרטי אימות נדרשים וכללו את אתגר WWW-Authenticate.

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

הנחיה תפעולית: התייחסו למשמעויות ייחודיות לספק ככאלה ותעדו את חוזה ה-API.

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

הנחיה תפעולית: בדקו הרשאות, מדיניות גישה, כללי IP/WAF ואישור גישה ברמת המשאב.

השרת אינו מוצא ייצוג עדכני עבור ה-URI המבוקש או אינו מוכן לחשוף שהוא קיים. התגובה לבדה אינה מציינת אם ההיעדר זמני או קבוע.

הנחיה תפעולית: תקנו את כתובת ה-URL, שחזרו את המשאב או השתמשו ב-410 כאשר ידוע שההסרה קבועה.

המשאב קיים אך אינו תומך בשיטה ששימשה בבקשה.

הנחיה תפעולית: החזירו כותרת Allow המפרטת את השיטות שהמשאב מקבל.

השרת אינו יכול ליצור ייצוג התואם להעדפות Accept היזומות של הלקוח.

הנחיה תפעולית: רככו את מגבלות Accept או הגדירו מדיניות מתאימה של ייצוג או משא ומתן.

שרת proxy מתווך דורש פרטי אימות לפני שיעביר את הבקשה.

הנחיה תפעולית: בצעו אימות מול ה-proxy באמצעות Proxy-Authenticate / Proxy-Authorization; הוא נפרד מאימות מול שרת המקור.

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

הנחיה תפעולית: בדקו עצירות ברשת, גודל העלאה והגדרות timeout בשרת או ב-proxy.

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

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

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

הנחיה תפעולית: השתמשו כשההסרה מכוונת; הסירו קישורים פנימיים והפניות שהתיישנו.

השרת דורש כותרת Content-Length, אך הבקשה לא סיפקה אותה.

הנחיה תפעולית: שלחו Content-Length מדויק או השתמשו במסגור העברה נתמך.

תנאי בבקשה, כגון If-Match, הוערך כשקרי ולכן השרת לא ביצע את הפעולה המבוקשת.

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

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

הנחיה תפעולית: צמצמו את המטען או התאימו מגבלות העלאה מתועדות.

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

הנחיה תפעולית: השתמשו ב-URI קצר יותר או העבירו נתונים מתאימים לגוף הבקשה.

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

הנחיה תפעולית: שלחו Content-Type וקידוד נתמכים וגוף שתואם להם.

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

הנחיה תפעולית: בדקו שוב את אורך המשאב ואת יחידות הטווח; שרתים עשויים להחזיר Content-Range: bytes */length.

השרת או המתווך אינם יכולים לעמוד בציפייה שהוצהרה בכותרת Expect.

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

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

הנחיה תפעולית: אל תסתמכו עליו להתנהגות ייצורית תואמת בין מערכות.

הבקשה הגיעה לשרת שאינו יכול להפיק תגובה סמכותית עבור URI היעד, לעיתים עקב אי-התאמה בין ניתוב החיבור לבין authority של HTTP.

הנחיה תפעולית: נסו שוב בחיבור מתאים ובדקו Host/:authority, SNI וניתוב proxy.

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

הנחיה תפעולית: החזירו פרטי אימות ישימים לכל שדה; תיקון המטען עשוי לאפשר הצלחה.

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

הנחיה תפעולית: בדקו בעלות על הנעילה, timeout וטיפול באסימון הנעילה של WebDAV.

פעולת WebDAV נכשלה משום שפעולה קודמת נדרשת באותה סדרת בקשות נכשלה.

הנחיה תפעולית: פתרו את הפעולה הכושלת הקודמת לפני ניסיון חוזר של פעולות תלויות.

השרת מסרב לעבד בקשה שייתכן שהושמעה מחדש במהלך early data כדי לצמצם סיכון להפעלה חוזרת.

הנחיה תפעולית: נסו שוב לאחר יצירת החיבור ללא early data.

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

הנחיה תפעולית: כללו כותרת Upgrade המתארת פרוטוקולים נתמכים.

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

הנחיה תפעולית: אחזרו מצב נוכחי ושלחו תנאי מתאים, כגון If-Match.

הלקוח שלח יותר מדי בקשות בפרק זמן מסוים לפי הגבלת הקצב שהשרת הגדיר.

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

השרת לא יעבד את הבקשה משום ששדה כותרת אחד או יותר, או קבוצת הכותרות כולה, גדולים מדי.

הנחיה תפעולית: צמצמו קובצי Cookie או כותרות מותאמות, או שנו מגבלת שרת מכוונת.

השרת אינו יכול לספק את המשאב המבוקש עקב מגבלה משפטית.

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

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

הנחיה תפעולית: קשרו את הבקשה ליומני השרת והימנעו מחשיפת מעקב מחסנית למבקרים.

השרת אינו תומך בפונקציונליות הדרושה למילוי הבקשה, בדרך כלל שיטה או יכולת שלא מומשו.

הנחיה תפעולית: ממשו את היכולת או השתמשו בשיטה נתמכת; הקוד אינו מיועד לעומס זמני.

שרת הפועל כשער או כ-proxy קיבל תגובה לא תקינה משרת upstream.

הנחיה תפעולית: בדקו תקינות upstream, הגדרות פרוטוקול ו-TLS, DNS ויומני proxy.

השרת אינו יכול לטפל בבקשה באופן זמני, לעיתים עקב תחזוקה או עומס יתר.

הנחיה תפעולית: אם אפשר, ספקו Retry-After, תגובה מועילה והוראות מטמון שמתאימות לכשל זמני.

שער או שרת proxy לא קיבלו תגובה בזמן משירות upstream.

הנחיה תפעולית: בדקו השהיה ב-upstream, נתיבי רשת ומכסות timeout לאורך השרשרת.

השרת אינו תומך בגרסת HTTP הראשית ששימשה בבקשה.

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

שגיאת תצורת שרת יצרה מעגל במשא ומתן על תוכן, שבו הגרסה שנבחרה מנהלת שוב משא ומתן.

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

שרת WebDAV אינו יכול לאחסן את הייצוג הדרוש להשלמת הפעולה.

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

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

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

הבקשה דורשת הרחבה שהשרת אינו תומך בה.

הנחיה תפעולית: השתמשו בקבוצת הרחבות נתמכת או נהלו משא ומתן על חלופה.

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

הנחיה תפעולית: השלימו אימות גישה לרשת ואז נסו שוב את הבקשה המקורית.

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

הנחיה תפעולית: רעננו אימות בהתאם לחוזה השירות.

תגובה ייחודית לספק ששימשה בעבר להגבלת קצב. משמעותה מוגדרת לפי המימוש.

הנחיה תפעולית: פעלו לפי הנחיות הגבלת הקצב המתועדות.

שרתים מסוימים סוגרים את החיבור בלי לשלוח תגובה רגילה, לעיתים כאמצעי סינון.

הנחיה תפעולית: בדקו יומני ספק; לקוחות עשויים לדווח על שגיאת רשת במקום להציג קוד זה.

הרחבה של Microsoft שבה שירותים מסוימים מבקשים מהלקוח לנסות שוב עם מידע נוסף.

הנחיה תפעולית: פעלו לפי תיעוד ה-API המסוים.

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

הנחיה תפעולית: בדקו ביטולי לקוחות ובקשות upstream איטיות.

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

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

CDN או שרת proxy עשויים להשתמש בכך כאשר מתקבלת תגובת מקור בלתי צפויה או ריקה.

הנחיה תפעולית: השוו יומני edge ושרת המקור; ודאו ששרת המקור שולח תגובת HTTP תקינה.

שרת proxy לא הצליח ליצור חיבור לשרת המקור או שהמקור סירב לחיבור.

הנחיה תפעולית: בדקו זמינות מקור, כללי חומת אש ורשימות היתרים של proxy.

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

הנחיה תפעולית: בדקו את זמן התגובה של המקור ואת השהיית הרשת.

שרת proxy לא הצליח להגיע לכתובת המקור שהוגדרה.

הנחיה תפעולית: בדקו פתרון DNS, ניתוב והגדרת כתובת IP של המקור.

החיבור למקור הצליח, אך המקור לא שלח תגובת HTTP בזמן.

הנחיה תפעולית: קצרו את זמן עיבוד המקור או התאימו הגדרות timeout נתמכות.

שרת proxy לא הצליח להשלים משא ומתן TLS עם המקור.

הנחיה תפעולית: אמתו אישורים, תאימות פרוטוקול וצופן ו-SNI.

מתווך דחה את אישור המקור במהלך האימות.

הנחיה תפעולית: התקינו אישור תקף, בעל שם נכון, מהימן ושלא פג תוקפו, וכן שרשרת מלאה.

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

הנחיה תפעולית: בדקו את המחבר הייחודי לספק ואת הנתיב למקור.

לקוחות או שרתי proxy מסוימים משתמשים בערך זה לתיאור timeout בקריאת רשת. אין לו משמעות HTTP אוניברסלית.

הנחיה תפעולית: בדקו אבחון לקוח או proxy.

שרתי proxy מסוימים משתמשים בערך זה כאשר ניסיון חיבור לרשת מסתיים ב-timeout. משמעותו תלויה במימוש.

הנחיה תפעולית: בדקו נגישות והגדרות timeout.