כל מפתח שומר רשימה קצרה מנטלית של קודי סטטוס HTTP שלי היה פעם 200, 404, ו 500, ובמשך זמן רב זה היה מספיק כדי לזייף יכולת ואז ביליתי שבוע בבניית אינטגרציה תשלום שבו ה - API החזיר 402 עבור כרטיס נדחה, 409 כאשר ניסיתי שוב תשלום שכבר עבר, ו 429 כאשר הבדיקות שלי פגע זה מהר מדי פתאום ההבדל בין קודים היה ההבדל בין תכונה עובדת כרטיס תמיכה אני בונה הרבה כלי אינטרנט עבור Toolz.dev, והפניה לקוד סטטוס ניתנת לחיפוש היא אחד מהדברים שאני מגיע אליהם כל הזמן, אז בניתי אחד באתר וכתבתי את המדריך הזה שיתאים לו.
TL;DR: קוד סטטוס HTTP הוא מספר תלת ספרתי ששרת שולח בחזרה כדי לתאר את התוצאה של בקשה הספרה הראשונה מגדירה את המחלקה: 1xx אינפורמטיבי, 2xx הצלחה, 3xx ניתוב מחדש, 4xx שגיאת לקוח, 5xx שגיאת שרת חפש כל אחד מהם באופן מיידי עם ה כלי קודי סטטוס HTTP, המאפשר לך לחפש לפי מספר, שם או מילת מפתח ומצטט את ה-RFC שמגדיר כל אחד מהם.
מדריך זה עובר על מה הם קודי סטטוס, מה המשמעות של כל מחלקה, הקודים הספציפיים שכדאי לשנן, ואלו שאנשים טועים לרוב. זה מכוון למפתחים קדמיים שמפרקים באגים בשיחות API, מפתחים עורפיים שמחליטים מה להחזיר, וכל מי שעושה קידום אתרים טכני שצריך הפניות מחדש כדי להתנהג.
מהו קוד סטטוס HTTP?
בכל פעם שהדפדפן או האפליקציה שלך מבקשים משהו דרך האינטרנט, השרת עונה בתגובה השורה הראשונה של אותה תגובה מכילה קוד סטטוס: מספר בן שלוש ספרות, בשילוב עם ביטוי סיבה קצר כמו "OK" או "לא נמצא". הקוד הוא הסיכום הניתן לקריאה במכונה של מה שקרה, וביטוי הסיבה הוא התווית הידידותית לאדם. לקוחות פועלים לפי המספר; הביטוי מיועד לאנשים שקוראים יומנים.
קודי סטטוס מוגדרים על ידי כוח המשימה להנדסת אינטרנט, בעיקר ב-RFC 9110, שאיחד את מפרטי ה-HTTP הישנים יותר בשנת 2022. רישום מרכזי שמתוחזק על ידי IANA מפרט כל קוד מוכר רשמית. הסטנדרטיזציה הזו היא המאפשרת לדפדפן שנכתב על ידי חברה אחת לדבר עם שרת שנכתב על ידי אחרת ולהסכים על המשמעות של 404 כלי קודי סטטוס HTTP משקף את הרישום הזה, מפרט כל קוד סטנדרטי עם המשמעות שלו ואת ה-RFC שמגדיר אותו.
המודל המנטלי המרכזי הוא שהספרה הראשונה אומרת לך את הקטגוריה, והקטגוריה אומרת לך מי אחראי קוד 4xx אומר שהלקוח שלח משהו לא בסדר קוד 5xx אומר שהשרת נכשל בבקשה שהייתה בסדר ההבחנה הבודדת הזו פותרת את רוב טיעוני ניפוי הבאגים לגבי הבאג של מי זה.
מה המשמעות של חמש מחלקות קוד הסטטוס?
יש בדיוק חמש מחלקות, מקובצות לפי הספרה המובילה הבנת המחלקה היא בעלת ערך רב יותר משינון קודים בודדים, כי היא אומרת לך היכן לחפש.
המחלקה 1xx היא אינפורמטיבי קודים אלה לאותת כי השרת קיבל את הבקשה ועיבוד ממשיך הם נדירים בעבודה יומיומית הידוע ביותר הוא 100 המשך, והשימושי ביותר המודרני אחד הוא 103 רמזים מוקדמים, אשר מאפשר לשרת לספר לדפדפן להתחיל טעינה מראש משאבים לפני התגובה המלאה מוכנה.
המחלקה 2xx פירושה הצלחה הבקשה התקבלה, הובנה, והתקבלה.200 OK הוא קוד ההצלחה היומיומי, 201 Created מאשר משאב חדש נעשה, ו 204 No Content אומר "עשה, שום דבר לשלוח בחזרה", אשר נפוץ עבור פעולות מחיקה.
המחלקה 3xx היא ניתוב מחדש המשאב חי במקום אחר, או לא השתנה מאז הלקוח האחרון ראה את זה מחלקה זו היא המקום שבו SEO חי, כי 301 ו 302 לספר מנועי החיפוש אם מהלך הוא קבוע.304 לא שונה הוא סוס עבודה מטמון שחוסך רוחב פס עצום.
המחלקה 4xx היא שגיאת לקוח הבקשה הייתה פגומה, לא מורשית, או הצביע על משהו שאינו קיים.400, 401, 403, 404, ו 429 כל לחיות כאן.When you see a 4xx, check what your code sended before you black the server.
המחלקה 5xx היא שגיאת שרת הבקשה הייתה תקפה אך השרת לא הצליח למלא אותה. 500, 502, 503 ו-504 הם אלו שתפגשו באירועי ייצור, בדרך כלל מצביעים על קריסה, שירות עמוס מדי או תלות שבורה במעלה הזרם.
אילו קודי סטטוס HTTP צריך לדעת כל מפתח?
אתה לא צריך את כל שישים פלוס הקודים בראש שלך אתה צריך אולי חמש עשרה, ואת השאר אתה מסתכל למעלה הנה סט העבודה אני חושב מרוויח מקום קבוע בזיכרון, עם המצבים שמפעילים אותם.
| קוד | משמעות | כשתראה את זה |
|---|---|---|
| 200 | בסדר | בקשה מוצלחת רגילה |
| 201 | נוצר | POST או PUT יצרו משאב חדש |
| 204 | אין תוכן | הצלחה עם גוף ריק, נפוץ לאחר DELETE |
| 301 | עבר לצמיתות | כתובת URL זזה לתמיד; SEO דירוג העברות |
| 302 | נמצא | הפניה זמנית; המשך להשתמש בכתובת האתר הישנה |
| 304 | לא שונה | עותק שמור עדיין בתוקף; אף גוף לא נשלח |
| 400 | בקשה גרועה | תחביר שגוי או מסגור בקשה לא חוקי |
| 401 | לא מורשה | האימות חסר או נכשל |
| 403 | אסור | מאומת אך אסור |
| 404 | לא נמצא | המשאב לא קיים |
| 409 | קונפליקט | הבקשה מתנגשת עם המצב הנוכחי |
| 422 | תוכן בלתי ניתן לעיבוד | תחביר חוקי, כללי אימות כושלים |
| 429 | יותר מדי בקשות | התעריף מוגבל; לסגת ולנסות שוב |
| 500 | שגיאת שרת פנימית | כשל בשרת בלתי צפוי |
| 503 | שירות לא זמין | שרת עמוס יתר על המידה או בתחזוקה |
שאר הרישום, מ-226 IM בשימוש עד 451 לא זמין מסיבות משפטיות, שווה לזהות אך לא לשנן. בשביל זה בדיוק נועד כלי חיפוש.
מה ההבדל בין 401 ל-403?
הזוג הזה מכשיל כמעט את כולם, אז מגיע לו קטע משלו. שניהם מתכוונים שהגישה נדחתה, אבל מסיבות שונות, וההבדל משנה את האופן שבו האפליקציה שלך צריכה להגיב.
A 401 Unauthorized פירושו שהבקשה חסרה אימות חוקי השרת אינו יודע מי אתה או שלא שלחת אישורים, או שאלו ששלחת היו שגויים או שפג תוקפם התגובה הנכונה מהצד שלך היא להיכנס או לרענן את האסימון לפי מפרט, תגובה 401 צריכה לכלול כותרת WWW-Authenticate שאומרת ללקוח כיצד לאמת.
403 אסור פירושו שהשרת יודע בדיוק מי אתה וממילא מסרב אתה מאומת אבל לא מורשה למשאב המסוים הזה כניסה שוב לא תעזור, כי הבעיה היא הרשאות, לא זהות משתמש רגיל שפוגע בנקודת קצה של מנהל בלבד צריך לקבל 403.
הכלל המהיר שבו אני משתמש: 401 הוא "מי אתה?", 403 הוא "אני יודע מי אתה, ולא". אם אתה בונה API ורוצה ליצור את כותרות ההרשאה כדי לבדוק את הזרימות הללו, ה מחולל מחברים בסיסי מייצר את האישורים המקודדים שאתה צריך.
מדוע הפניות 301 לעומת 302 חשובות לקידום אתרים?
הפניות מחדש הן המקום שבו קודי סטטוס מפסיקים להיות פרט יישום פנימי ומתחילים להשפיע על דירוג החיפוש שלך. כאשר אתה מעביר דף, קוד המצב שאתה מחזיר אומר למנועי החיפוש מה לעשות עם ה-URL' הישן; סמכות מצטברת.
A 301 Moved Permanently מאותת שהמהלך סופי מנועי החיפוש מפילים את כתובת האתר הישנה מהאינדקס שלהם לאורך זמן, מעבירים את אותות הדירוג לכתובת האתר החדשה ומעדכנים את הקישורים שלהם זה הקוד הרצוי כאשר משנים שם של דף, מעבירים ל-HTTPS או מאחדים כתובות URL כפולות השימוש בו נכון הוא אחד התיקונים הנפוצים ביותר בביקורת SEO טכנית.
A 302 נמצא מאותת על מהלך זמני מנועי חיפוש שומרים את כתובת האתר המקורית באינדקס מכיוון שאמרת להם שהשינוי אינו קבוע אם אתה משתמש ב-302 עבור מהלך שהוא קבוע, אתה יכול לתקוע את הדירוג שלך בכתובת URL שאינך משתמש בה יותר ראיתי אתרים מאבדים את הנראות במשך חודשים מכיוון שמסגרת ברירת המחדל היא 302 הפניות מחדש במהלך העברת HTTPS.
ישנם גם 307 הפניה זמנית ו-308 הפניה קבועה, שמתנהגים כמו 302 ו-301 אך מבטיחים ששיטת ה-HTTP והגוף נשמרים השתמש ב-307 ו-308 עבור בקשות שאינן GET שבהן שינוי השיטה ישבור דברים אם אתה מבקר כיצד סורקים רואים את האתר שלך, חבר את הידע הזה עם מחולל robots.txt וה מחולל מטא תגים כדי לוודא שכל תמונת הזחילה וההפניה מחדש עקבית. ה ערכת כלים למפתחי אינטרנט מדריך קושר את החלקים האלה יחד.
מהם קודי השגיאה הנפוצים ביותר בשרת וכיצד מבצעים ניפוי באגים?
המחלקה 5xx היא המקום שבו תקריות ייצור לחיות, וכל קוד מפנה אותך בשכבה אחרת של הערימה. Knowing אשר הוא אשר חוסך זמן אמת במהלך הפסקה.
שגיאת שרת פנימית של 500 היא התפס הגנרי. זה אומר שקוד היישום שלך זרק חריג שלא טופל או פגע במצב שהוא לא הצליח לעבד. התיקון נמצא כמעט תמיד ביומנים שלך. 500 הוא השרת שאומר " משהו נשבר ואין לי מילה טובה יותר לזה", אז הקוד אומר לך איפה לחפש אבל לא מה השתבש.
502 Bad Gateway ו-504 Gateway Timeout מגיעים שניהם משרת הפועל כשער או פרוקסי, כגון מאזן עומסים או פרוקסי הפוך מול האפליקציה שלך. A 502 פירושו שהמעלה הזרם שלח בחזרה משהו לא חוקי, לעתים קרובות בגלל שהאפליקציה שלך קרסה או לא פועלת. 504 פירושו שלמעלה הזרם לקח יותר מדי זמן להגיב והשער ויתר על ההמתנה. אם אתה רץ מאחורי Nginx, CDN או מאזן עומסים בענן, אלו הקודים שתראה כשהדבר מאחורי ה-proxy אינו בריא.
שירות 503 לא זמין פירושו שהשרת אינו מסוגל באופן זמני לטפל בבקשה, בדרך כלל בגלל שהיא עמוסה מדי או בתחזוקה תגובות 503 שמתנהגות היטב כוללות כותרת ניסיון חוזר לאחר שאומרת ללקוחות מתי לחזור שליחת 503 במהלך תחזוקה מתוכננת היא הדרך הנכונה, בטוחה לקידום אתרים, להוריד אתר לזמן קצר, מכיוון שהוא אומר למנועי החיפוש לחזור מאוחר יותר במקום להניח שהדפים נעלמו. למבט רחב יותר על אבחון בעיות אינטרנט, ה כלי פרודוקטיביות למפתחים המדריך מכסה את ערכת הכלים הרחבה יותר.
מה לגבי קודי המצב הפחות נפוצים?
מעבר לסט העבודה, הרישום מחזיק זנב ארוך של קודים שתפגשו מדי פעם, וזיהוי שלהם חוסך חצי שעה מבולבלת. כמה שווים סיור מהיר.
במשפחת 2xx, 206 Partial Content מפעיל הורדות הניתנות לחידוש והזרמת וידאו כאשר לקוח שולח כותרת Range המבקשת בתים 500 עד 999 של קובץ, השרת עונה 206 עם הפרוסה הזו בדיוק. כך מתחדש הורדה מושהית במקום להתחיל מחדש, וכיצד דפדפן מחפש לאמצע סרטון מבלי להביא את כל העניין קודם.
במשפחת 4xx, 410 Gone הוא גרסה חזקה יותר, מכוונת יותר של 404. Where 404 says "I could not find it", 410 says "it was here, it is permanently gone, stop ask". Using 410 for content you have intentiently remove it faster than a 404 would.Another useful one is 451 Unavailable For Legal Reasons, which number is a nod to the novel Fahrenheit 451, returned when content is blocked by a legal order such as a takedown or a court inviction.
יש גם 418 I' m a Teapot, קוד רשום אמיתי ממפרט באפריל 1998 שקומקום תה מחזיר כאשר הוא מתבקש לבשל קפה. זה לא משמש לתנועה רגילה, אבל הוא מופיע כביצת פסחא בחלק מממשקי API, וזו תזכורת קטנה לכך שלאנשים שכתבו את הסטנדרטים האלה היה חוש הומור הכלי מפרט את כל אלה כדי שתוכל לחפש כל דבר שאתה נתקל בו בלי לנחש.
כיצד כלי HTTP Status Codes עוזר?
הכלי פשוט בכוונה, כי העבודה פשוטה: יש לך קוד או סימפטום, ואתה רוצה את המשמעות מהר אתה יכול לחפש לפי המספר, לפי ביטוי הסיבה כמו "not found", או לפי מילת מפתח מהתיאור כמו "redirect" או "rate limit". אתה יכול לסנן למחלקה בודדת כדי לעיין רק בהפניות מחדש או רק בשגיאות השרת. כל ערך מציג את ביטוי הסיבה, הסבר פשוט מתי הקוד חל, וה-RFC שמגדיר אותו, כך שתוכל לאשר התנהגות מול המקור הראשי.
מכיוון שהרישום כולו נטען בדפדפן שלך, החיפוש הוא מיידי ועובד במצב לא מקוון ברגע שהדף פתוח. שום דבר שאתה מחפש לא נשלח לשום מקום. זה סוג ההפניה שאני שומר בלשונית בזמן בניית API, ממש ליד מנתח סוכן משתמש לבדיקת כותרות בקשות.
שאלות נפוצות
מהן חמש המחלקות של קודי סטטוס HTTP?
קודי סטטוס HTTP מקובצים לפי הספרה הראשונה שלהם: 1xx informational, 2xx success, 3xx redirection, 4xx client error, and 5xx server error.The class tells you at a glance ifly a request cealled, was redirected, or failed on the client or server side, which is enorally enough to know where to start debugging.
מה המשמעות של קוד סטטוס 404?
A 404 Not Found פירושו שהשרת לא הצליח למצוא את המשאב המבוקש ייתכן שכתובת האתר הייתה שגויה באיות, ייתכן שהדף נמחק, או שהקישור נשבר זהו קוד שגיאת לקוח, כך שהבקשה הגיעה לשרת אך הצביעה על משהו שלא קיים שם.
מה ההבדל בין הפניה 301 ל-302?
A 301 Moved Permanently אומר ללקוחות ולמנועי החיפוש שהמשאב עבר לתמיד, אז הם מעדכנים את הקישורים שלהם ומעבירים אותות דירוג לכתובת האתר החדשה. A 302 Found הוא הפניה זמנית, כך שכתובת האתר המקורית צריכה להמשיך לשמש לבקשות עתידיות ומנועי חיפוש שומרים אותה באינדקס.
מה המשמעות של שגיאת שרת פנימית של 500?
שגיאת שרת פנימית של 500 היא הודעה גנרית שמשמעותה שהשרת פגע במצב בלתי צפוי שלא יכול היה להתמודד איתו. זה מאותת על בעיה בשרת ולא בבקשה, כך שהתיקון הוא בדרך כלל בקוד היישום או בתצורה, ויומני השרת שלך הם המקום לחפש בו.
מתי API צריך להחזיר 400 לעומת 422?
החזר 400 Bad Request כאשר הבקשה עצמה שגויה, כגון JSON לא חוקי או כותרת נדרשת חסרה. החזר 422 תוכן בלתי ניתן לעיבוד כאשר התחביר תקף אך הנתונים נכשלים בכללי עסקים או אימות, כגון אימייל שכבר נלקח או ערך מחוץ לטווח.
מהו קוד 429 Too Many Requests?
429 בקשות רבות מדי פירושו שהלקוח שלח יותר מדי בקשות בזמן קצר והוא מוגבל בתעריף. התגובה כוללת לעתים קרובות כותרת ניסיון חוזר שאומרת ללקוח כמה זמן לחכות לפני שינסה שוב, ולקוחות מתנהגים היטב מכבדים אותה עם גיבוי אקספוננציאלי.
האם ההפניה לקוד סטטוס HTTP חופשית לשימוש?
כן הכלי חינמי לחלוטין ללא הרשמה וללא מגבלות, והוא פועל במצב לא מקוון לאחר טעינת הדף מכיוון שכל הרשימה פועלת בדפדפן שלך שום דבר שאתה מחפש לא נשלח לשרת, כך שהוא בטוח ומהיר לשימוש בזמן ניפוי באגים.
