نوسین و ئامادەکردنی
فێرکار
ڕێنمایەکی تەواو بۆ کۆدەکانی حاڵەتی HTTP
کاتێک وێبگەڕەکەت داواکارییەک دەنێرێت بۆ سێرڤەرێک، سێرڤەرەکە وەڵامێک دەگەڕێنێتەوە کە پێکهاتووە لە کۆدی حاڵەتێک کە پێمان دەڵێت داواکارییەکە سەرکەوتوو بووە یان نا. لەم بابەتەدا، هەموو کۆدەکانی حاڵەتی HTTP ڕوون دەکەینەوە.
پۆلەکانی سەرەکی
کۆدەکانی حاڵەتی HTTP بۆ پێنج پۆلی سەرەکی دابەش کراون:
- 1xx (زانیاری): داواکارییەکە وەرگیراوە و پرۆسەکە بەردەوامە
- 2xx (سەرکەوتوو): داواکارییەکە بە سەرکەوتوویی وەرگیراوە و پرۆسێس کراوە
- 3xx (ڕەوانەکردنەوە): پێویستە هەنگاوی زیاتر بکرێت بۆ تەواوکردنی داواکارییەکە
- 4xx (هەڵەی کلایەنت): داواکارییەکە هەڵەیەکی تێدایە یان ناتوانرێت جێبەجێ بکرێت
- 5xx (هەڵەی سێرڤەر): سێرڤەرەکە شکستی هێناوە لە جێبەجێکردنی داواکارییەکی دروست
1xx - کۆدەکانی زانیاری
100 Continue (بەردەوامبە)
واتا: سێرڤەرەکە بەشی سەرەتای داواکارییەکەی وەرگرتووە و کلایەنت دەتوانێت بەردەوام بێت لە ناردنی باقی داواکارییەکە.
کەی بەکاردێت: لە داواکارییە گەورەکاندا کە کلایەنت دەیەوێت دڵنیابێت سێرڤەرەکە ئامادەیە پێش ناردنی هەموو داتاکان.
101 Switching Protocols (گۆڕینی پرۆتۆکۆڵەکان)
واتا: سێرڤەرەکە ڕازی بووە بە گۆڕینی پرۆتۆکۆڵەکە بەپێی داواکاری کلایەنت.
کەی بەکاردێت: بۆ نموونە کاتێک گۆڕین لە HTTP بۆ WebSocket.
102 Processing (لە پرۆسەدایە)
واتا: سێرڤەرەکە داواکارییەکەی وەرگرتووە و کاری لەسەر دەکات، بەڵام هێشتا وەڵامێکی نییە.
103 Early Hints (ئاماژە پێشوەختییەکان)
واتا: سێرڤەرەکە هەندێک زانیاری سەرەتایی دەنێرێت پێش ئەوەی وەڵامی تەواو ئامادە بکات.
2xx - کۆدەکانی سەرکەوتن
200 OK (باشە)
واتا: داواکارییەکە بە سەرکەوتوویی جێبەجێ کراوە. ئەمە باشترین وەڵامە!
کەی بەکاردێت: کاتێک هەموو شتێک بەباشی کاردەکات - GET، POST، PUT یان DELETE سەرکەوتووە.
201 Created (دروستکرا)
واتا: داواکارییەکە سەرکەوتوو بووە و سەرچاوەیەکی نوێ دروست کراوە.
کەی بەکاردێت: پاش داواکارییەکی POST کە بەکارهێنەرێکی نوێ یان پۆستێکی نوێ دروست دەکات.
202 Accepted (وەرگیرا)
واتا: داواکارییەکە وەرگیراوە بۆ پرۆسەکردن، بەڵام پرۆسەکە تەواو نەبووە.
کەی بەکاردێت: بۆ کارە درێژخایەنەکان کە لە پاشبنەمادا پرۆسێس دەکرێن.
203 Non-Authoritative Information (زانیاری نادەسەڵاتدار)
واتا: سێرڤەرەکە داواکارییەکەی بە سەرکەوتوویی پرۆسێس کردووە، بەڵام زانیارییە گەڕاوەکە لە سەرچاوەی سەرەکی نییە.
204 No Content (ناوەڕۆکی نییە)
واتا: سێرڤەرەکە داواکارییەکەی بە سەرکەوتوویی پرۆسێس کردووە بەڵام ناوەڕۆکێک ناگەڕێنێتەوە.
کەی بەکاردێت: کاتێک فایلێک دەسڕیتەوە یان نوێکردنەوەیەک دەکەیت بێ ئەوەی پێویستت بە وەڵامێک بێت.
205 Reset Content (ڕێکخستنەوەی ناوەڕۆک)
واتا: سێرڤەرەکە داواکارییەکەی جێبەجێ کردووە و کلایەنت دەبێت بینینی بەڵگەنامەکە ڕێکبخاتەوە.
206 Partial Content (ناوەڕۆکی بەشەیی)
واتا: سێرڤەرەکە تەنها بەشێک لە سەرچاوەکە دەگەڕێنێتەوە بەهۆی سەرپەڕەی بوارێکی دیاریکراو.
کەی بەکاردێت: بۆ داگرتنی بەشێک لە فایل یان ڤیدیۆ ستریمینگ.
3xx - کۆدەکانی ڕەوانەکردنەوە
300 Multiple Choices (چەندین هەڵبژاردە)
واتا: چەندین هەڵبژاردەی جیاواز هەیە بۆ سەرچاوەکە.
301 Moved Permanently (بە هەمیشەیی گوێزرایەوە)
واتا: پەڕەکە بە هەمیشەیی گوازراوەتەوە بۆ URLـێکی نوێ.
کەی بەکاردێت: کاتێک دۆمەینێک یان پەڕەیەک بە شێوەیەکی هەمیشەیی دەگۆڕیت.
302 Found (دۆزرایەوە)
واتا: پەڕەکە کاتیانە لە URLـێکی جیاواز دۆزراوەتەوە.
کەی بەکاردێت: بۆ ڕەوانەکردنەوەی کاتی.
303 See Other (سەیری ئەوی تر بکە)
واتا: وەڵامەکە دەتوانرێت لە URLـێکی تر بدۆزرێتەوە و دەبێت بە GET وەریبگیرێت.
304 Not Modified (گۆڕانکاری نەکراوە)
واتا: سەرچاوەکە لەو کاتەوە گۆڕانکاری نەکراوە کە کلایەنت بۆ دواجار وەریگرتووە.
کەی بەکاردێت: بۆ کاش کردن - وێبگەڕەکە دەتوانێت وێنەی کاش کراو بەکاربهێنێت.
307 Temporary Redirect (ڕەوانەکردنەوەی کاتی)
واتا: داواکارییەکە دەبێت بە کاتی بنێردرێت بۆ URLـێکی تر، بە هەمان شێوازی HTTP.
308 Permanent Redirect (ڕەوانەکردنەوەی هەمیشەیی)
واتا: سەرچاوەکە بە هەمیشەیی لە URLـێکی تر دایە، بە هەمان شێوازی HTTP.
4xx - کۆدەکانی هەڵەی کلایەنت
400 Bad Request (داواکاری هەڵە)
واتا: سێرڤەرەکە ناتوانێت داواکارییەکە پرۆسێس بکات بەهۆی هەڵەی سینتاکسی.
کەی بەکاردێت: کاتێک فۆرمێک بە شێوەیەکی هەڵە پڕ دەکرێتەوە یان JSON نادروستە.
401 Unauthorized (بێ مۆڵەت)
واتا: پێویستە بەکارهێنەر خۆی بسەلمێنێت بۆ دەستگەیشتن بە سەرچاوەکە.
کەی بەکاردێت: کاتێک بەکارهێنەر چوونەژوورەوەی نەکردووە یان تۆکێنەکەی بەسەرچووە.
402 Payment Required (پێویستی بە پارەدانە)
واتا: ئەم کۆدە بۆ بەکارهێنانی داهاتوو هەڵگیراوەتەوە.
403 Forbidden (قەدەغەیە)
واتا: سێرڤەرەکە داواکارییەکەی تێگەیشت بەڵام ڕەتیدەکاتەوە.
کەی بەکاردێت: کاتێک بەکارهێنەر چوونەژوورەوەی کردووە بەڵام مۆڵەتی دەستگەیشتنی نییە بە سەرچاوەکە.
404 Not Found (نەدۆزرایەوە)
واتا: سێرڤەرەکە سەرچاوە داواکراوەکەی نەدۆزیوەتەوە.
کەی بەکاردێت: ئەم هەرە باوترین هەڵەیە - کاتێک پەڕەیەک بوونی نییە یان سڕاوەتەوە.
405 Method Not Allowed (شێواز ڕێگەپێنەدراوە)
واتا: شێوازی داواکاری (GET، POST، هتد) پشتگیری نەکراوە بۆ ئەم سەرچاوەیە.
کەی بەکاردێت: کاتێک POST بەکاردەهێنیت لە شوێنێکدا کە تەنها GET قبووڵە.
406 Not Acceptable (قبووڵ نییە)
واتا: سەرچاوەکە تەنها لە فۆرماتێکدا بەردەستە کە لەلایەن کلایەنتەوە قبووڵ نییە.
407 Proxy Authentication Required (پێویستی بە سەلماندنی پرۆکسییە)
واتا: کلایەنت دەبێت خۆی لەگەڵ پرۆکسی بسەلمێنێت.
408 Request Timeout (کاتی داواکاری بەسەرچوو)
واتا: سێرڤەرەکە ماندوو بووە لە چاوەڕوانی داواکارییەکە.
409 Conflict (ناکۆکی)
واتا: داواکارییەکە ناکۆکییەکی هەیە لەگەڵ دۆخی ئێستای سێرڤەرەکە.
کەی بەکاردێت: کاتێک هەوڵدەدەیت فایلێک دروست بکەیت کە پێشتر بوونی هەیە.
410 Gone (ڕۆیشتووە)
واتا: سەرچاوەکە پێشتر بەردەست بووە بەڵام ئێستا بە هەمیشەیی لابراوە.
کەی بەکاردێت: وەک 404 بەڵام ئاماژە بەوە دەکات سەرچاوەکە بە مەبەست سڕاوەتەوە.
411 Length Required (درێژی پێویستە)
واتا: سێرڤەرەکە ڕەتدەکاتەوە داواکارییەکە قبووڵ بکات بێ سەرپەڕەی Content-Length.
412 Precondition Failed (مەرجی پێشوەخت سەرنەکەوت)
واتا: یەک یان زیاتر لە مەرجەکانی خستووەتە سەرپەڕەکاندا هەڵەیە.
413 Payload Too Large (بارگرانی زۆر گەورەیە)
واتا: داواکارییەکە گەورەترە لەوەی سێرڤەر بتوانێت پرۆسێسی بکات.
کەی بەکاردێت: کاتێک هەوڵدەدەیت فایلێکی زۆر گەورە بار بکەیت.
414 URI Too Long (URI زۆر درێژە)
واتا: URI زۆر درێژە بۆ ئەوەی سێرڤەرەکە پرۆسێسی بکات.
415 Unsupported Media Type (جۆری میدیا پشتگیری نەکراوە)
واتا: فۆرماتی میدیای داواکارییەکە پشتگیری ناکرێت.
کەی بەکاردێت: کاتێک JSON دەنێریت بەڵام سێرڤەرەکە تەنها XML قبووڵ دەکات.
416 Range Not Satisfiable (بوار جێبەجێ ناکرێت)
واتا: بواری داواکراو لە سەرچاوەکە نییە.
417 Expectation Failed (چاوەڕوان سەرنەکەوت)
واتا: سێرڤەرەکە ناتوانێت چاوەڕوانییەکانی سەرپەڕەی Expect بگەیەنێت.
418 I'm a teapot (من کوتاڵەی چایم)
واتا: گاڵتەیەکی یەکی ئاوریل - سێرڤەرەکە ڕەت دەکاتەوە قاوە دروست بکات چونکە کوتاڵەی چایە!
تێبینی: ئەمە گاڵتەیەکی RFC 2324 ـیە بەڵام هەندێک سێرڤەر بەکاری دەهێنن.
421 Misdirected Request (داواکاری بە هەڵە ڕێنمایی کراوە)
واتا: داواکارییەکە ناردراوە بۆ سێرڤەرێک کە ناتوانێت وەڵامێک دروست بکات.
422 Unprocessable Entity (نەتوانی پرۆسێس بکرێت)
واتا: داواکارییەکە باشە بەڵام ناتوانرێت پرۆسێس بکرێت بەهۆی هەڵەی سیمانتیکی.
کەی بەکاردێت: بۆ نموونە کاتێک JSON دروستە بەڵام داتاکە ڕێسا سەروەر نەگرتووە.
423 Locked (قفڵکراوە)
واتا: سەرچاوەکە قفڵکراوە.
424 Failed Dependency (پشتبەستن سەرنەکەوت)
واتا: داواکارییەکە سەرنەکەوت بەهۆی سەرنەکەوتنی داواکارییەکی پێشوو.
425 Too Early (زۆر زوو)
واتا: سێرڤەرەکە ئامادە نییە لەوەی مەترسی هەڵە بکەوێت لە پرۆسێسکردنی داواکاری کە ڕەنگە دووبارە بکرێتەوە.
426 Upgrade Required (پێویستی بە نوێکردنەوەیە)
واتا: کلایەنت دەبێت بگۆڕێت بۆ پرۆتۆکۆڵێکی جیاواز.
428 Precondition Required (پێویستی بە مەرجی پێشوەختە)
واتا: سێرڤەرەکە پێویستی بە مەرجی داواکارییە.
429 Too Many Requests (داواکاری زۆر)
واتا: بەکارهێنەر زۆر داواکاریی ناردووە لە ماوەیەکی کەمدا.
کەی بەکاردێت: بۆ سنووردانانی ڕێژە (rate limiting) - کاتێک زۆرت بەکاردەهێنیت!
431 Request Header Fields Too Large (خانەکانی سەرپەڕەی داواکاری زۆر گەورەن)
واتا: سێرڤەرەکە نایەوێت داواکارییەکە پرۆسێس بکات چونکە سەرپەڕەکانی زۆر گەورەن.
451 Unavailable For Legal Reasons (بەردەست نییە بەهۆی هۆکاری یاسایی)
واتا: سەرچاوەکە بەهۆی یاسایی بەردەست نییە.
کەی بەکاردێت: کاتێک ناوەڕۆکێک لە وڵاتێکدا قەدەغە کراوە.
5xx - کۆدەکانی هەڵەی سێرڤەر
500 Internal Server Error (هەڵەی ناوخۆی سێرڤەر)
واتا: سێرڤەرەکە تووشی دۆخێکی نەچاوەڕوان بووە و نەیتوانی داواکارییەکە جێبەجێ بکات.
کەی بەکاردێت: ئەمە هەڵەیەکی گشتی سێرڤەرە - شتێک هەڵە ڕۆیشتووە بەڵام سێرڤەر زانیاری زیاتری نییە.
501 Not Implemented (جێبەجێ نەکراوە)
واتا: سێرڤەرەکە پشتگیری لە کارایی پێویست ناکات بۆ جێبەجێکردنی داواکارییەکە.
کەی بەکاردێت: کاتێک سێرڤەرەکە شێوازی داواکاری (وەک PUT یان DELETE) ناناسێت.
502 Bad Gateway (گەیتوەی هەڵە)
واتا: سێرڤەرەکە، کاتێک وەک گەیتوەی یان پرۆکسی کاردەکات، وەڵامێکی نادروستی وەرگرتەوە.
کەی بەکاردێت: کاتێک سێرڤەری خوارەوە خاومۆشە یان بە هەڵە دەگەڕێتەوە.
503 Service Unavailable (خزمەتگوزاری بەردەست نییە)
واتا: سێرڤەرەکە ئامادە نییە داواکارییەکە پرۆسێس بکات (زۆرجار بەهۆی چاککردنەوە یان زۆر بارگرانی).
کەی بەکاردێت: کاتێک سێرڤەر خاومۆشە بۆ چاککردنەوە یان زۆر قەرەباڵغە.
504 Gateway Timeout (کاتی گەیتوەی بەسەرچوو)
واتا: سێرڤەرەکە وەڵامێکی وەختیی وەرنەگرتەوە لە سێرڤەری خوارەوە.
کەی بەکاردێت: کاتێک سێرڤەری خوارەوە زۆر خاوە یان گەیشتن پێی ناکرێت.
505 HTTP Version Not Supported (وەشانی HTTP پشتگیری ناکرێت)
واتا: سێرڤەرەکە پشتگیری لە وەشانی HTTP بەکارهاتوو لە داواکارییەکە ناکات.
506 Variant Also Negotiates (جۆرەکەش دانوستان دەکات)
واتا: هەڵەی ڕێکخستنی ناوخۆ - سێرڤەرەکە جۆرەی هەڵبژێردراو خۆی ڕێکخراوە بۆ دانوستان.
507 Insufficient Storage (شوێنی ناکافی)
واتا: سێرڤەرەکە ناتوانێت نمایشکردنەکە هەڵبگرێت کە پێویستە بۆ تەواوکردنی داواکارییەکە.
508 Loop Detected (لوپ بینرا)
واتا: سێرڤەرەکە لوپی بێکۆتایی بینیوە لە کاتی پرۆسێسکردنی داواکارییەکە.
510 Not Extended (درێژ نەکراوەتەوە)
واتا: پێویستە درێژکردنەوەی زیاتر بۆ داواکارییەکە بکرێت.
511 Network Authentication Required (پێویستی بە سەلماندنی تۆڕە)
واتا: کلایەنت پێویستە خۆی بسەلمێنێت بۆ دەستگەیشتن بە تۆڕەکە.
کەی بەکاردێت: لە WiFi گشتیدا کاتێک دەبێت چوونەژوورەوە بکەیت پێش بەکارهێنانی ئینتەرنێت.
کورتکراوە
کۆدەکانی باش (سەوز 🟢):
- 200 OK - هەموو شتێک باشە!
- 201 Created - شتێکی نوێ دروست کرا
- 204 No Content - سەرکەوتوو بەڵام ناوەڕۆکی نییە
کۆدەکانی ڕەوانەکردنەوە (شین 🔵):
- 301 Moved Permanently - بە هەمیشەیی گوازرایەوە
- 302 Found - بە کاتی گوازرایەوە
- 304 Not Modified - بەکارهێنانی وێنەی کاش کراو
کۆدەکانی هەڵەی کلایەنت (سوور 🔴):
- 400 Bad Request - داواکارییەکە هەڵەیە
- 401 Unauthorized - چوونەژوورەوە پێویستە
- 403 Forbidden - مۆڵەتت نییە
- 404 Not Found - نەدۆزرایەوە
- 429 Too Many Requests - زۆر خێرایت!
کۆدەکانی هەڵەی سێرڤەر (سوور تۆخ 🔴):
- 500 Internal Server Error - شتێک لە سێرڤەردا هەڵە ڕۆیشتووە
- 502 Bad Gateway - گەیتوەی هەڵە
- 503 Service Unavailable - سێرڤەر خاومۆشە
- 504 Gateway Timeout - کاتی گەیتوەی بەسەرچوو
زانیاری زیاتر
چۆن کۆدەکانی حاڵەت دیاری دەکرێن؟
- ژمارەی یەکەم پۆلەکە دیاری دەکات (١xx, ٢xx, ٣xx, ٤xx, ٥xx)
- ژمارەکانی دیکە دۆخی تایبەتەکە دیاری دەکەن
پرسیارە باوەکان (FAQ)
پ : جیاوازی نێوان 401 و 403 چییە؟ وـ: 401 واتە "خۆت بسەلمێنە" (چوونەژوورەوە پێویستە)، 403 واتە "من دەزانم تۆ کێیت، بەڵام مۆڵەتت نییە".
پ : کەی دەبێت 204 بەکاربهێنم لە شوێنی 200؟ و: 204 بەکاربهێنە کاتێک کارەکە سەرکەوتوو بووە بەڵام پێویست بە گەڕاندنەوەی داتا نییە (وەک DELETE).
پ : جیاوازی نێوان 502، 503، و 504 چییە؟ و :
- 502: سێرڤەر وەڵامێکی هەڵەی گەڕاندەوە
- 503: سێرڤەر ئامادە نییە (چاککردنەوە/زۆر قەرەباڵغە)
- 504: سێرڤەر زۆر خاو وەڵامی دایەوە
پ: کەی دەبێت 301 بەکاربهێنم لە شوێنی 302؟ و: 301 بەکاربهێنە بۆ ڕەوانەکردنەوەی هەمیشەیی (SEO دەپارێزێت)، 302 بۆ ڕەوانەکردنەوەی کاتی.
کۆتایی
تێگەیشتنی کۆدەکانی حاڵەتی HTTP زۆر گرنگە بۆ هەر گەشەپێدەرێک. ئەم کۆدانە وێبەکە دەکەن بە شوێنێکی تێگەیشتوتراو و ڕێکوپێک. هیوادارم ئەم ڕێنماییە بۆت سوودبەخش بووبێت!