מדריך קודי סטטוס HTTP
| קוד | שם | משמעות |
|---|---|---|
| 100 | המשך | על הלקוח להמשיך עם גוף הבקשה |
| 101 | החלפת פרוטוקולים | שודרג פרוטוקול התקבל (למשל ל-WebSocket) |
| 200 | OK | הבקשה הצליחה — תגובת ההצלחה ברירת המחדל |
| 201 | נוצר | משאב חדש נוצר (הצלחת POST טיפוסית) |
| 202 | התקבל | בתור לעיבוד אסינכרוני, עדיין לא הושלם |
| 204 | אין תוכן | הצלחה עם גוף ריק בכוונה |
| 301 | הועבר לצמיתות | למשאב יש כתובת קבועה חדשה — עדכנו קישורים; הון SEO מועבר |
| 302 | נמצא | הפניה זמנית (היסטורית נעשה בה שימוש לרעה; ראו 303/307) |
| 303 | ראה אחר | הפניה ל-GET בכתובת אחרת (post/redirect/get) |
| 304 | לא שונה | עותק שמור עדיין תקף — אמתו מחדש באמצעות ETag/Last-Modified |
| 307 | הפניה זמנית | הפניה זמנית השומרת על שיטה וגוף |
| 308 | הפניה קבועה | הפניה קבועה השומרת על שיטה וגוף |
| 400 | בקשה לא תקינה | השרת אינו יכול לנתח/להבין את הבקשה |
| 401 | לא מורשה | נדרש אימות או שהוא נכשל (למרות השם, הכוונה ללא-אומת) |
| 403 | אסור | בין אם אומת או לא, הגישה נדחית |
| 404 | לא נמצא | אין משאב בכתובת זו |
| 405 | השיטה אינה מותרת | שיטת ה-HTTP אינה נתמכת למשאב הזה |
| 406 | לא מקובל | אף ייצוג לא מתאים לכותרות Accept |
| 408 | פג זמן הבקשה | הלקוח לקח יותר מדי זמן לשלוח את הבקשה |
| 409 | קונפליקט | התנגשות מצב, למשל התנגשות עריכה או יצירה כפולה |
| 410 | אינו קיים עוד | הוסר לצמיתות (חזק יותר מ-404 — משמש בכוונה) |
| 411 | נדרש אורך | נדרשת כותרת Content-Length |
| 413 | התוכן גדול מדי | גוף הבקשה חורג ממגבלות השרת |
| 414 | כתובת ארוכה מדי | הכתובת חורגת ממגבלות השרת |
| 415 | סוג מדיה לא נתמך | סוג-התוכן של הבקשה אינו נתמך |
| 418 | אני קומקום תה | בדיחת RFC 2324, משמשת לעיתים לסירוב לחליטת קפה |
| 422 | תוכן לא ניתן לעיבוד | התחביר תקין אבל הסמנטיקה נכשלת באימות (ממשקי API אוהבים את זה) |
| 425 | מוקדם מדי | השרת אינו מוכן לעבד בקשה שייתכן ששוחזרה |
| 429 | יותר מדי בקשות | מגבלת קצב הוכתה — צעדו אחורה, כבדו את Retry-After |
| 500 | שגיאת שרת פנימית | כשל גנרי בצד השרת |
| 501 | לא מומש | השרת אינו תומך בפונקציונליות |
| 502 | שער לא תקין | שרת proxy/gateway קיבל תגובה לא תקפה מה-upstream |
| 503 | השירות אינו זמין | עמוס יתר או מושבת לתחזוקה — לעיתים קרובות זמני, עשוי לשאת Retry-After |
| 504 | פג זמן השער | פג זמן ההמתנה של proxy/gateway ל-upstream |
| 505 | גרסת HTTP לא נתמכת | גרסת ה-HTTP בבקשה אינה נתמכת |
אודות
קודי סטטוס הם סיכום בן-מספר של השרת על כל תגובה, מקובצים לפי מחלקה: 1xx מידע, 2xx הצלחה, 3xx הפניה, 4xx הלקוח שגה, 5xx השרת שגה. הטבלה נותנת את הקודים שמפתחים עובדים באמת פוגשים, עם הניואנסים שחשובים במעשה — 401 פירושו לא מאומת למרות שמו, 403 הוא סירוב ללא קשר לכניסה, 422 הוא כשל אימות API, 429 דורש צעד אחורה. קודים שאינם ברשימה (הזנב הארוך של 1xx וקודים ניסיוניים) נדירים מספיק שהמחלקה לבדה אומרת לכם איך לטפל בהם.
שאלות נפוצות
מה ההבדל בין 401 ל-403?
401: איננו יודעים מי אתם (בצעו אימות). 403: אנו יודעים, ועדיין אסור לכם.
302 או 307 להפניה זמנית?
307 שומר על השיטה ועל הגוף; 302 אפשר היסטורית ללקוחות להחליף POST ל-GET. בעבודה חדשה יש להשתמש ב-307 (או 308 לקבועה).