ነፃ የHTTP Status Codes ማጣቀሻ

ለExpect: 100-continue ጥያቄዎች ጥቅም ላይ ይውላል። አገልጋዩ ደንበኛው ከመላኩ በፊት አካሉን ለመቀበል ፈቃደኛ መሆኑን ያረጋግጣል። በዘመናዊ ድረ-ገጾች ላይ አልፎ አልፎ ይታያል።

በጣም በተለምዶ ለWebSocket ማሻሻያዎች ጥቅም ላይ ይውላል — ደንበኛው Upgrade: websocket ይጠይቃል፣ አገልጋዩ ደግሞ ለመቀየር 101 ምላሽ ይሰጣል።

ረጅም ስራዎችን በሚያከናውንበት ጊዜ የደንበኛ ጊዜ ማለቅን ለመከላከል የሚላክ የWebDAV ጊዜያዊ ምላሽ። ጊዜ ያለፈበት — ዘመናዊ አገልጋዮች መላክ የለባቸውም።

የመጨረሻው ምላሽ በሚዘጋጅበት ጊዜ አገልጋዮች የLink ራስጌዎችን (preload/preconnect) እንዲልኩ ያስችላል፣ ስለዚህ አሳሾች ወሳኝ ንብረቶችን ቀድመው ማምጣት ይጀምራሉ።

መደበኛው የስኬት ምላሽ። ትርጉሙ በHTTP ዘዴው ይወሰናል፦ GET → ንብረት ተመልሷል፣ POST/PUT → ተግባር ተጠናቅቋል።

ከPOST በኋላ የተለመደ። ምላሹ ወደ አዲሱ ንብረት URL የሚያመለክት Location ራስጌ ማካተት አለበት።

ለአሲንክ ስራዎች — አገልጋዩ ስራውን በተራ እያስቀመጠ ነው። ደንበኛው የሁኔታ endpoint መጠየቅ ወይም በኋላ መመልከት አለበት።

ጥያቄው ተሳክቷል፣ ነገር ግን አማካይ (እንደ ማከማቻ ወይም ተለዋጭ ፕሮክሲ ያለ) ከመነሻ አገልጋዩ የተላለፈውን ይዘት ቀይሯል — ለምሳሌ ምስሎችን እንደገና በመጨመቅ። በተግባር ብርቅ ነው።

ብዙውን ጊዜ ለDELETE ስራዎች ወይም አካል መመለስ ለማያስፈልጋቸው PUT ማዘመኛዎች ጥቅም ላይ ይውላል። ደንበኛው ከአሁኑ ገጽ መውጣት የለበትም።

እንደ 204፣ ምንም አካል አይመለስም — ግን ደንበኛው ጥያቄውን ያመነጨውን ቅጽ ወይም እይታ ዳግም እንዲያስጀምር ተጨማሪ ትዕዛዝ ይደርሰዋል (ለምሳሌ ለቀጣዩ ግቤት የቅጽ መስኮችን ማጽዳት)።

ለRange ጥያቄ ምላሽ። በተቋረጡ ውርዶች ለመቀጠል ወይም ትላልቅ ፋይሎችን ለማጓጓዝ በቪዲዮ ማጫወቻዎችና በውርድ አስተዳዳሪዎች ጥቅም ላይ ይውላል።

WebDAV፦ አንድ XML አካል የበርካታ ንዑስ-ስራዎችን ውጤት በተናጠል ያሳውቃል — ለምሳሌ አንዳንድ ንጥሎች የተሳኩበት እና ሌሎች ያልተሳኩበት የጅምላ ማዛወሪያ።

WebDAV፦ ትስስሮች ዙር ሲፈጥሩ አንድ ስብስብ አባላትን ደጋግሞ ላለመዘርዘር በ207 Multi-Status ምላሾች ውስጥ ጥቅም ላይ ይውላል።

ዴልታ ኢንኮዲንግ፦ ባንድዊድዝ ለመቆጠብ አገልጋዩ ሙሉ ምንጩን ፋንታ ከቀድሞው ስሪት ጋር ያለውን ልዩነት ይመልሳል። እምብዛም ተግባራዊ አይደረግም።

አገልጋዩ በርካታ አማራጮችን (ለምሳሌ የተለያዩ ቅርጸቶች ወይም ቋንቋዎች) ያቀርባል እና ደንበኛው አንዱን መምረጥ አለበት። ራስ-ሰር የይዘት ድርድር ብዙውን ጊዜ ይህን ስለሚያከናውን እምብዛም ጥቅም ላይ አይውልም።

ለቋሚ የURL ለውጦች ይጠቀሙ — የፍለጋ ሞተሮች ማውጫቸውን ያዘምናሉ። የSEO ስልጣን ወደ አዲሱ URL ይተላለፋል።

ዙሩ ቋሚ አለመሆኑን ያመለክታል። ካሺንግ ከ301 ያነሰ ጥብቅ ነው። እንደ 'መግባት ያስፈልጋል፣ ወደ /login በማዞር ላይ' ላሉ ነገሮች ይጠቀሙ።

ከPOST ማስገባቶች በኋላ ጥቅም ላይ ይውላል — ምላሹ 'POSTዎ ሰርቷል፣ ለውጤቱ ይህን GET URL ይመልከቱ' ይላል። አሳሾች ሁልጊዜ አዲሱን URL GET ያደርጋሉ።

ለቅድመ-ሁኔታ ጥያቄ (ከIf-None-Match ወይም If-Modified-Since ራስጌዎች ጋር) ምላሽ። ባንድዊድዝ ይቆጥባል — ምንም አካል አይመለስም።

የመጀመሪያው POST ከነበረ፣ ዙሩም POST ይጠቀማል። የስልት ጠባቂነት አስፈላጊ ሲሆን ከ302 ይልቅ ዘመናዊ አማራጭ ነው።

POST ጥያቄዎች ከዙር በኋላ POST ሆነው እንዲቆዩ ሲፈለግ ከ301 ይልቅ ዘመናዊ ምትክ ነው።

የተለመዱ ምክንያቶች፦ በአካል ውስጥ የተሳሳተ JSON፣ ልክ ያልሆኑ የጥያቄ መለኪያዎች፣ ወይም የጎደሉ አስፈላጊ መስኮች። የጥያቄውን አካል እና ራስጌዎች ያረጋግጡ።

ደንበኛው የማረጋገጫ ማስረጃ (Authorization ራስጌ፣ ኩኪ፣ ቶክን) ማካተት አለበት። 'Unauthorized' የተሳሳተ ስያሜ ነው — በእውነቱ ማለት 'ያልተረጋገጠ' ማለት ነው።

በመጀመሪያ ለዲጂታል ክፍያዎች የታሰበ። ዘመናዊ አጠቃቀም፦ ተጠቃሚ የከፈለ ኮታውን ሲያልፍ APIዎች አንዳንዴ 402 ይመልሳሉ።

ከ401 የተለየ — ተጠቃሚው ገብቷል፣ ነገር ግን መለያው ለዚህ ምንጭ ፈቃድ የለውም። የሚና/ፈቃድ አመክንዮን ያረጋግጡ።

ወይ URLው ትክክል አይደለም፣ ምንጩ ተሰርዟል፣ ወይም ፈጽሞ አልነበረም። አገልጋዮች 403 ትክክለኛ ምላሽ መሆኑን ለመደበቅ አንዳንዴ 404 ይመልሳሉ።

ለምሳሌ POST ብቻ ወደሚቀበል መድረሻ የGET ጥያቄ። ምላሹ ትክክለኛ ስልቶችን የሚዘረዝር Allow ራስጌ ማካተት አለበት።

ደንበኛው (በAccept፣ Accept-Language፣ Accept-Encoding በኩል) አገልጋዩ ማሟላት የማይችለውን የይዘት አይነት፣ ቋንቋ ወይም ኢንኮዲንግ ጠይቋል። ብዙ አገልጋዮች ጥብቅ ድርድርን ትተው ነባሪ ይመልሳሉ።

እንደ 401 ነው፣ ግን በፕሮክሲ ይሰጣል፦ ደንበኛው Proxy-Authorization ማስረጃ መላክ አለበት። በማረጋገጫ ፕሮክሲ ባላቸው የኩባንያ አውታረ መረቦች ላይ ይታያል።

ደንበኛው የጥያቄውን አካል ለመላክ ብዙ ጊዜ ወስዷል ወይም ግንኙነቱን ስራ ፈት ትቶታል። ጥያቄውን እንደገና ይሞክሩ።

በተለምዶ ለተመሳሳይ ጊዜ ማስተካከያ ግጭቶች ወይም የተባዛ ምንጭ ፍጠራ (ለምሳሌ አስቀድሞ ላለ ኢሜይል አዲስ ተጠቃሚ መፍጠር) ይመለሳል።

ከ404 የበለጠ ጠንካራ ነው — አገልጋዩ ምንጩ ቀደም ሲል እንደነበረ ግን በቋሚነት እንደተወገደ በግልጽ ያውቃል። የፍለጋ ሞተሮች ከማውጫ ያስወግዱታል።

ጥያቄው Content-Length ራስጌ ስላልነበረው ውድቅ ተደርጓል እና አገልጋዩ ያልታወቀ መጠን ያላቸውን አካላት ይከለክላል። ራስጌውን ጨምረው እንደገና ይሞክሩ።

እንደ If-Match ወይም If-Unmodified-Since ያሉ ቅድመ-ሁኔታ ራስጌዎች ሲወድቁ ይመለሳል — በተለምዶ ተስፋ ሰጪ መቆለፍ፦ ስሪትዎ ከተገኘ በኋላ ሌላ ሰው ምንጩን ቀይሮታል። እንደገና ይላኩ እና ይሞክሩ።

ትላልቅ ፋይሎች ሲላኩ የተለመደ ነው። የአገልጋይ ውቅር (nginx፣ apache) ከፍተኛ የአካል መጠን ያዘጋጃል። የአገልጋዩን ውቅር ያረጋግጡ።

ብዙውን ጊዜ በጣም ረጅም የጥያቄ ክሮች (ለምሳሌ በGET ውስጥ ውሂብ ማስቀመጥ) ያስከትሉታል። ወደ POST አካል ይቀይሩ፣ ወይም አገልጋዩን የሚቆጣጠሩ ከሆነ ገደቡን ከፍ ያድርጉ።

ለምሳሌ application/json ብቻ ወደሚቀበል አገልጋይ application/xml መላክ። Content-Type ራስጌን በትክክል ያዘጋጁ።

Range ራስጌ ፋይሉ የሌለውን ክፍል ይጠይቃል — ለምሳሌ ፋይሉ ካለቀ በኋላ ማውረድን መቀጠል። ምላሹ ትክክለኛውን መጠን የያዘ Content-Range ማካተት አለበት።

አገልጋዩ Expect: 100-continue ስለማይደግፍ ይላካል። አንዳንድ ደንበኞች ይህን ራስጌ በነባሪነት ለትላልቅ POSTዎች ይልካሉ፤ ማሰናከል ብዙውን ጊዜ ስህተቱን ይፈታል።

ከ1998 (RFC 2324) የሚያዝያ አንደኛ ቀልድ። አንዳንድ እውነተኛ APIዎች ለቀልድ ወይም ጊዜ ያለፈባቸውን መድረሻዎች ለማመልከት ይጠቀሙበታል። ለምርት ጥቅም ላይ አይውልም።

በHTTP/2 ግንኙነት ድጋሚ አጠቃቀም የተለመደ ነው፦ ጥያቄው ለታለመው ሆስት ስም ያልተዋቀረ አገልጋይ ደርሷል። ደንበኛው በአዲስ ግንኙነት እንደገና መሞከር አለበት።

ለምሳሌ JSON በትክክል ተነተነ ግን አስፈላጊ መስክ ጎድሏል፣ ወይም የመስክ ዋጋ ከክልል ውጭ ነበር። በREST API ማረጋገጫ ምላሾች ውስጥ የተለመደ ነው።

WebDAV፦ ምንጩ ወይም መድረሻው በሌላ ደንበኛ ተቆልፏል፣ ስለዚህ ክንዋኔው መቀጠል አይችልም። መቆለፊያው እስኪለቀቅ ይጠብቁ ወይም በትክክለኛው ቶክን ይስበሩት።

WebDAV፦ በተከታታይ ጥገኛ ክንዋኔዎች ውስጥ፣ ቀደም ያለ ድርጊት ስላልተሳካ ይህ አልተከናወነም። ለዋናው ምክንያት ቀደመውን ውድቀት ይመልከቱ።

ከTLS 1.3 0-RTT (ቀደምት ውሂብ) ጋር የተያያዘ፦ አገልጋዩ ድጋሚ ሊላክ የሚችል ጥያቄን የማስተናገድ አደጋ አይወስድም። ደንበኛው ግንኙነቱ ከተጠናቀቀ በኋላ እንደገና መሞከር አለበት።

አገልጋዩ ጥያቄውን በአሁኑ ፕሮቶኮል ማገልገል ይከለክላል ግን ከማሻሻያ በኋላ ያገለግላል — ምላሹ የሚያስፈልገውን ፕሮቶኮል የሚጠቅስ Upgrade ራስጌ ያካትታል።

አገልጋዩ የጠፉ ማዘመኛ ግጭቶችን ለመከላከል ቅድመ-ሁኔታ ራስጌዎችን (እንደ If-Match) ይጠይቃል። ምንጩን ያምጡ፣ ETagውን ይያዙ፣ እና ከIf-Match ጋር እንደገና ይላኩ።

ፍጥነትን ይቀንሱ። ምላሹ መቼ እንደገና መሞከር እንዳለበት የሚያመለክት Retry-After ራስጌ ማካተት አለበት። የጥያቄ ኮታ ላላቸው APIዎች የተለመደ ነው።

ወይ አንድ ራስጌ ወይም አጠቃላይ የራስጌ መጠን ገደቡን ይበልጣል — ብዙውን ጊዜ ከልክ በላይ ትላልቅ ኩኪዎች ያስከትሉታል። ኩኪዎችን ያጽዱ ወይም መተግበሪያዎ በኩኪ የሚያከማቸውን ይቀንሱ።

ምንጩ በህጋዊ ምክንያቶች ታግዷል — ሳንሱር፣ የፍርድ ቤት ትዕዛዞች፣ ወይም የክልል ደንቦች። ቁጥሩ ለFahrenheit 451 ልቦለድ ማጣቀሻ ነው።

ለአገልጋይ-ጎን ስህተቶች አጠቃላይ ማጠቃለያ። ትክክለኛውን ምክንያት ለማወቅ የአገልጋይ ምዝግቦችን ያረጋግጡ፦ ያልተያዘ ልዩ ሁኔታ፣ የመረጃ ቋት ስህተት፣ ወዘተ።

ለምሳሌ አገልጋዩ የHTTP ስልቱን አያውቀውም። በተግባር ላይ ብርቅ ነው — ከዚህ ይልቅ 405 ይታያል።

በማይክሮሰርቪስ አርክቴክቸሮች ውስጥ የተለመደ። ጭነት አመጣጣኝዎ ወይም ግልባጭ ፕሮክሲዎ ከጀርባ አገልግሎቱ ስህተት ያለበት ምላሽ አግኝቷል።

ወይ ለጥገና ተዘግቷል ወይም ጭነት በዝቶበታል። ምላሹ Retry-After ራስጌ ማካተት አለበት። ብዙውን ጊዜ በማሰማራት ወቅት ይመለሳል።

የጀርባ አገልግሎቱ በበቂ ፍጥነት አልመለሰም። የከፍተኛ አገልግሎት ጤናን እና የጊዜ ማብቂያ ውቅሮችን ያረጋግጡ።

የጥያቄው ዋና HTTP ስሪት በአገልጋዩ አይደገፍም። በዘመናዊ ደንበኞች ፈጽሞ አይታይም።

ግልጽ የይዘት ድርድር በዙር ውስጥ ተጠናቅቋል፦ የተመረጠው ተለዋጭ ራሱ ለመደራደር የተዋቀረ ነው። የአገልጋይ ውቅር ስህተትን ያመለክታል።

በመነሻው WebDAV-ተኮር ነው ግን አንዳንዴ በአጠቃላይ አገልጋዮች ጥቅም ላይ ይውላል። ማለት አገልጋዩ በማከማቻ ገደብ ምክንያት ጥያቄውን ማስቀመጥ አልቻለም ማለት ነው።

WebDAV፦ Depth: infinity ጥያቄን ማስኬድ ወደ ዙር ገባ (ለምሳሌ ክብ ትስስሮች)። ክንዋኔው ተቋርጧል።

ከቆየው HTTP Extension Framework፦ አገልጋዩ ጥያቄውን ከመፈፀሙ በፊት ተጨማሪ መረጃ ያስፈልገዋል። በዘመናዊው ድር ውስጥ በተግባር ጥቅም ላይ አይውልም።

ተጠቃሚው ወደ ውጫዊ ጣቢያዎች ከመድረሱ በፊት ወደ አውታረ መረቡ መግባት እንዳለበት ለማመልከት በምርኮኛ ፖርታሎች (ሆቴል/አየር ማረፊያ ዋይፋይ) ጥቅም ላይ ይውላል።