לוגו Loona AutomationLoona כלי פיתוח
בית › מדריך עזר

מדריך קודי סטטוס HTTP

בקצרה: כל קודי הסטטוס שחשובים בפיתוח יומי — מה כל אחד פירושו, מתי הוא משמש, והמלכודות (401 מול 403, ‏302 מול 307) — ניתן לסינון תוך כדי הקלדה.
🔒 פרטי לפי עיצוב: הכול רץ בדפדפן שלכם על המכשיר הזה. הקלט שלכם לעולם לא מועלה לשרת.
קודשםמשמעות
100המשךעל הלקוח להמשיך עם גוף הבקשה
101החלפת פרוטוקוליםשודרג פרוטוקול התקבל (למשל ל-WebSocket)
200OKהבקשה הצליחה — תגובת ההצלחה ברירת המחדל
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 לקבועה).

כלי מפתחים קשורים

הטמיעו את הכלי הזה באתר שלכם — בחינם

הוסיפו את הכלי הזה לאתר או לבלוג שלכם — זה לגמרי בחינם, לא צריך הרשמה, ותמיד מציג את הגרסה העדכנית ביותר. העתיקו את הקוד למטה והדביקו אותו בדף שלכם במקום שבו תרצו שהכלי יופיע. שמירת שורת הקרדיט הקטנה “Powered by Loona Automation” מתחת להטמעה עוזרת לשמור על הכלי הזה בחינם — אבל אתם חופשיים לעצב אותה או להסיר אותה; הכלי עובד בכל מקרה.