Негізгі мазмұнға өту

HTTP күй кодтары анықтамасы — тегін

Барлық HTTP күй кодтарының іздеуге болатын анықтамасы — әрқайсысының мағынасы, қашан пайдаланылатыны және кең таралған себептері. 100-ден 511-ге дейін.

Жүктелгеннен кейін офлайн жұмыс істейді

61 статус коды

100

Жалғастыру

Сервер сұрау тақырыптарын қабылдаған және клиент денемен жалғастуы керек.

Expect: 100-continue сұраулары үшін пайдаланылады. Сервер денесін қабылдауға дайын екенін құрметпен түсіндіреді. Қазіргі веб-қосымшаларда сирек кеңсек.

RFC 9110 ↗
101

Протоколдарды ауыстыру

Сервер клиент сұрағы бойынша протоколдарды ауыстыруда.

Әрқашан WebSocket жаңартуы үшін қолданылады — клиент Upgrade: websocket сұрайды және сервер протоколдарды ауыстыру үшін 101 бағаларын білдіреді.

RFC 9110 ↗
102

Өңдеу

Сервер сұрауды қабылдаған және оны өндеуде болғанымен жауап әлі қол жетімді емес.

Ұзақ операциялар кезінде клиент тайм-аутын болдырмау үшін жіберілген WebDAV аралық жауап. Есте қалған — заманауи серверлер оны жіберсе болмайды.

RFC 2518 ↗
103

Ерте ыстамдықтар

Соңғы жаупастан бұрын танымдақ тақырыптар жіберілді.

Серверлерге Link тақырыптарын (алдын ала жүктеу/ынамдарының ортасы) жіберуге мүмкіндік беріңіз, соңғы жауап әлі дайындалуда болғанымен, браузерлер сыни активтерді тезірек алай алсын.

RFC 8297 ↗
200

Жарайды

Сұрау сәтті болды.

Стандартты сәтті жауп. Мағынасы HTTP әдісіне байланысты: GET → ресурс қайтарылды, POST/PUT → әрекет аяқталды.

RFC 9110 ↗
201

Құрылды

Жаңа ресурс сәтті құрылды.

POST соңында ортақ. Жауп жаңа ресурстың URL-сін көрсететін орын тақырыптарын құрмалауы керек.

RFC 9110 ↗
202

Ұйғарылды

Сұрау өңдеу үшін қабылданды, бірақ өңдеу аяқталмаған.

Асинхронды операциялар үшін — сервер жұмысты тізбектеп тұр. Клиент мәртебе нүктесінен сұрап немесе кейін қайта тексеруі керек.

RFC 9110 ↗
203

Ынамсыз ақпарат

Жауп ауыстыру прокси арқылы өзгертілді.

Сұрау сәтті болды, бірақ аралық (кэштеу немесе ауыстыру прокси сияқты) бастапқы сервер пайлоудан өзгерті — мысалы, суреттерді қайта сығып. Іс-әрекеттің іс-әрекеттегі сирек.

RFC 9110 ↗
204

Ешқандай құрамасы жоқ

Сұрау сәтті болды бірақ жауп денесі жоқ.

Әрқашан DELETE операциялары немесе денесін қайтармасы тыс PUT жаңартулары үшін пайдаланылады. Клиент ағымды бетінен қоса алмасы керек.

RFC 9110 ↗
205

Құрамасын қалпына келтіру

Сұрау сәтті болды; клиент құжат көрінісін қалпына келтіруі керек.

204 сияқты, денесі қайтарылмайды — бірақ клиентке сондай-ақ сұрауды қалпына келтіруі керек деп айтылады (мысалы, келесі жазба үшін пішін өрістерін анық).

RFC 9110 ↗
206

Ішінгі құрамасы

Сервер ресурстың тек бір бөлігін жеткізді.

Диапазон сұрауына жауп. Видео ойындар және жүктеу ақта болып қалған жүктемелерді өндеу немесе ірі файлдарды ағындау үшін пайдаланылады.

RFC 9110 ↗
207

Көп-Мәртебелі

Жауп денесі бірнеше операциялар үшін бірнеше мәртебелі кодтарын құрамасы.

WebDAV: XML денесі бірнеше ішкі операциялардың нәтижелерін өз бетінше хабарлайды — мысалы, қайда да қаттай болсын, кейбір элементтер сәтті болды және басқалары сәтсіз.

RFC 4918 ↗
208

Бұрыннан баяндалды

Жинақтың мүшелері жаупаның ішінде бұрыннан тізімделді.

WebDAV: 207 Көп-Мәртебелі жаупасы ішінде пайдаланылады, байланыстар ілмектерін құрагандағыда сол жинақтың мүшелерін қайт-қайт тізімдеуден сақтану үшін.

RFC 5842 ↗
226

IM Пайдаланылды

Жауп ресурсқа қолданылған мысал өндеулерінің нәтижесі.

Дельта кодтау: сервер қатарын сәлемдеңіз толық ресурсын орынына және оны кеңейту. Өте сирек енгізілген.

RFC 3229 ↗
300

Бірнеше таңдамалар

Ресурстың бірнеше ұсыну қол жетімді.

Сервер бірнеше опциялар (мысалы, түрлі пішіндер немесе тілдер) ұсынады және клиент біреуін таңдасы керек. Сирек пайдаланылады, себебі автоматты құрамасы үйлесімі әрқашан осыны өндейді.

RFC 9110 ↗
301

Түбегейлі ондағы орналастырылды

Ресурс түбегейлі жаңа URL-ге ондағы орналастырылды.

Тұрақты URL өзгерістері үшін пайдаланыңыз — іздеу машиналары олардың индексін жаңартады. SEO органы жаңа URL-ге ауысады.

RFC 9110 ↗
302

Табылды (Түбегейлі емес қайта бағыттау)

Ресурс уақытша басқа URL-де.

Қайта бағыттау түбегейлі емес екенін білдіреді. Кэштеу 301-ге қарағанда аз ағрессивті болады. Логиндеу қажет сияқты нәрселер үшін пайдаланыңыз, /login үшін қайта бағыттаңыз.

RFC 9110 ↗
303

Басқасын қараңыз

GET-пен басқа URL-ге қайта бағыттау.

POST ұсынысы соңында пайдаланылады — жауап 'сіздің POST істеді, бәлкім бұл GET URL-нде нәтижелер' болды. Браузерлер әрқашан жаңа URL-нің GET-і.

RFC 9110 ↗
304

Модификацияланмаған

Кэшінделген нұсқа әлі де құндықта; оны пайдаланыңыз.

Шартты сұрау үшін жауп (If-None-Match немесе If-Modified-Since тақырыптарымен). Кеңжігі ынамдап — денесі қайтарылмайды.

RFC 9110 ↗
307

Түбегейлі емес қайта бағыттау

302 сияқты бірақ түпнұсқа HTTP әдісін сақтайды.

Бастапқы POST болса, қайта бағыттау де POST пайдаланады. Заманауи әрі ым ұстатудан 302 үшін, әдіс сақтау саланы білік.

RFC 9110 ↗
308

Түбегейлі қайта бағыттау

301 сияқты бірақ түпнұсқа HTTP әдісін сақтайды.

Заманауи 301 ордатауы, сіз POST сұраулары қайта бағыттамадан кейін POST күю болсын десеңіз.

RFC 9110 ↗
400

Дұрыс емес сұрау

Сервер дұрыс емес синтаксистесінің сұрауын бола алмады.

Ортақ себептер: денесіндегі дұрыс емес JSON, қолаймау сұрау параметрлері немесе міндетті өрістердің жетіспеуі. Сұрау денесін және тақырыптарын тексеріңіз.

RFC 9110 ↗
401

Ынамсыз

Ынамдату қажет және берілмеген.

Клиент ынамдарды құрамасы (Authorization тақырыптары, cookie, токен) құрмалауы керек. 'Ынамсыз' - бұл дұрыс сөз емес — бұл 'аныықтаусыз' орынында болады.

RFC 9110 ↗
402

Төлем қажет

Болашаққа сақталмалы — кейде төлеген API деңгейлері үшін пайдаланылады.

Түпнұсқы цифрлық төлемдерге ниялы. Заманауи пайдалану: API кейде клиент төлеген квотасындай аршаған болса 402 қайтарады.

RFC 9110 ↗
403

Тыйым салынды

Клиент ынамдартылған бірақ рұқсатынсыз.

401-ге өзбе — пайдаланушы логинде, бірақ олардың есебі бұл ресурс үшін рұқсатынсыз. Рөлі/рұқсаттарының логикасын тексеріңіз.

RFC 9110 ↗
404

Табылмады

Сұралған ресурс құрамасы жоқ.

URL қайта дұрыс, ресурс өшірілді немесе ешқашан болмаған. Серверлер кейде 404 қайтарады, 403 дәл болса да жасыруға.

RFC 9110 ↗
405

Әдісі Тыйым салынды

HTTP әдісі қолданылады бұл ресурс үшін рұқсатты емес.

Мысалы, GET сұрау пункт ең қана POST қабылдайды. Жауп рұқсатты әдістер тізіметіндегі Allow тақырыптарын құрмалауы керек.

RFC 9110 ↗
406

Мұқтажсыз

Ешбір ұсыну клиент Accept тақырыптарына сәйкес келмейді.

Клиент ішінгі түрін, тілді немесе кодтауды сұрады (Accept, Accept-Language, Accept-Encoding арқылы) сервер орындау мүмкін емес. Көп серверлер қатаң келісімді өткіп жібер әрі орындапайды оreino.

RFC 9110 ↗
407

Прокси ынамдату қажет

Клиент алдымен прокси-сервер арқылы аутентификациялану қажет.

401 сияқты, бірақ прокси арқылы жиберілген: клиент Proxy-Authorization ынамдарын жіберуі керек. Фирма желілерінде ынамдартатын прокси бар.

RFC 9110 ↗
408

Сұрау уақыты аяқталды

Сервер сұраудың күтуінен сыршайды.

Клиент сұраудың денесін жіберуге көп уақыт затратты немесе байланысты бос қалдырды. Сұраудағы қайталап көрініз.

RFC 9110 ↗
409

Конфликт

Сұрау ресурстың ағымдағы күйімен қарай келеді.

Әдетте параллель редакциялау конфликттері немесе бөлінетін ресурстарды қайта құру кезінде қайтарылады (мысалы, уже бар электронды пошталық-адресі бар пайдаланушыны құру).

RFC 9110 ↗
410

Өшірілді

Ресурс өшірілді және қайта келмейді.

404-тен күштіріңіз — сервер ресурс БҰРЫН болғанын білсе де ішінара өшірілгені туралы білсе де. Іздеу Engine-дері индексін шығарады.

RFC 9110 ↗
411

Ұзындық қажет

Сервер Content-Length тақтасын талап етеді.

Сұрау Content-Length тақтасын ұмыткандықтан және сервер белгісіз өлшемінің денелерін қабылдамағандықтан төгінді. Тақтасын қосыңыз және қайталап көрініз.

RFC 9110 ↗
412

Алмауын аяқталды

Сұраудың тақталарындағы шарт орындалмады.

If-Match немесе If-Unmodified-Since сияқты шартты тақталар сәтсіз болғанда қайтарылады — әдетте оптимистік құлпы: сіздің нұсқаңыздан бері басқа адам ресурстағы өзгертілді. Қайта алыңыз және қайталап көрініз.

RFC 9110 ↗
413

Ауырлық пен ақауы

Сұрау денесі сервердің өлшемі шегінен асады.

Ірі файлдарды жүктегенде әдетті. Сервер конфигурациясы (nginx, apache) ең үлкен денелік өлшемін белгілейді. Сервердің конфигурациясын тексеріңіз.

RFC 9110 ↗
414

URI ұзындығы ұзын

Сұраудың URL-ы сервердің ұзындық шегінен асады.

Әдетте ұзақ сұраудың сөздері (мысалы, деректерді GET-ке кодтау) негізінде. POST денеге ауысыңыз немесе оны басқасаңыз өндіргіш сегізі көтеріңіз.

RFC 9110 ↗
415

Құрсақ медиялық түрі ұмытылған

Сервер жіберілген Content-Type іске асыра алмайды.

Мысалы, application/xml ды application/json ды ғана қабылдайтын серверге жіберу. Content-Type тақтасын дұрыс орнатыңыз.

RFC 9110 ↗
416

Диапазон қанағаттандырылмайды

Сұралған байт диапазоны ресурстың өлшемінен тыс.

Range тақтасы файлдың болмайтын бөлігін сорау етеді — мысалы, файлдың соңынан өткен жүктемені қалпына келтіру. Жауап Content-Range өлшемімен нақты болуы керек.

RFC 9110 ↗
417

Күту сәтсіз болды

Сервер Expect тақтасының талаптарын қана ала алмайды.

Сервер Expect: 100-continue қолдамағанда жіберіледі. Кейбір клиенттер бұл тақтасын ірі POST-та әдепті жіберсе; оны сөндіру әдетте қатеніміздің істі түзетіңіз.

RFC 9110 ↗
418

Мен шәйнек

Сервер қара болғанның салтанатында қара ішпеуді нұқс етеді.

1998 жылғы Сәйке өзінің тікелей шегетіндегі өнер (RFC 2324). Кейбір нәтижеленген API-лар оны өнер немесе есімсіз соңғы нүктелерді қолу үшін пайдаланады. Өндіру ұсынысы үшін емес.

RFC 2324 ↗
421

Мәмлекеттеліктік сұрау

Сұрау оны өндіре алмайтын серверге жіберілді.

HTTP/2 байланысын қайта пайдалану кезінде әдетті: сұрау мақсат хост атына әмес серверге жетті. Клиент жаңа байланыста қайта сынап көруі керек.

RFC 9110 ↗
422

Өндіру мүмкін емес мазмұны

Сұрау синтаксистік түрде дұрыс болса да семантикалық түрде қате болды.

Мысалы, JSON дұрыс синтаксиді болса да құрылымдық өліміндегі қажетті өріс болды немесе өрістің мәні диапазонынан шықты. REST API анықталуы жауап құрсағында әдетті.

RFC 9110 ↗
423

Құлпылы

Ресурс құлпылы.

WebDAV: өндіргіш немесе мақсат ресурсы басқа клиент тарапынан құлпылы, сондықтан іс-әрекет жалғаса алмайды. Құлпы босанғанға немесе оны дұрыс жетімімен сындыруға күтіңіз.

RFC 4918 ↗
424

Тәуелді іс-әрекет сәтсіз болды

Сұрау сәтсіз болды, себебі алдыңғы тәуелді сұрау сәтсіз болды.

WebDAV: тәуелді операциялар тізбесінде бұрынғы іс-әрекет сәтсіз болды, сондықтан бұл орындалмады. Әбіден сәтсіздіктің себебін кез келетіңіз.

RFC 4918 ↗
425

Ерте

Сервер ықтимал қайта ойналмалы сұраудың өндіруін қабылдамайды.

TLS 1.3 0-RTT (ерте деректер) қатынасы: сервер ықтимал қайта ойналмалы сұраудың өндіруін қауіпке төндіргісі келмейді. Клиент қолдау аяқталғаннан кейін қайталап көру керек.

RFC 8470 ↗
426

Жаңартуы қажет

Клиент басқа протоколъге ауысуы керек.

Сервер ағымдағы протоколъге сұрауды ұсынуды қабылдамайды, бірақ жаңарғаннан кейін қалпына келтіреді — жауапта қажетті протоколді атайтын Upgrade тақтасы болсын.

RFC 9110 ↗
428

Алмауы қажет

Сервер сұрау шартты болуын талап етеді.

Сервер шартты тақталарын (If-Match сияқты) жүсін-өтінімді конфликттерін болдырмау үшін талап етеді. Ресурсты алыңыз, оның ETag-ын айырыңыз және If-Match қосында қайта жіберіңіз.

RFC 6585 ↗
429

Көп сұрау

Клиент қысым шегіленіп жатыр.

Төмендеңіз. Жауап Retry-After тақтасын мәмлекеттік сынап көруге мәлімдеуі керек. API-лар сұраудың квоталарын ұтыраттыушы әдетті.

RFC 6585 ↗
431

Сұраудың тақталарының өлшемі ұзын

Тақталар сервердің өндіру үшін ұзындық.

Бір тақта немесе жалпы тақта өлшемі шегінен асады — ең ұсынған кіреңділ шақырылды. Печеньелерді өшіріңіз немесе олар іске асыратын өндіргіш ширектеуімен қысылтыңыз.

RFC 6585 ↗
451

Заңдық себептермен қол жеткізу мүмкін емес

Заңдық талап салты арқылы қол жеткізу төгінді.

Ресурс заңдық себептермен құлпылы — цензура, сот бұйрықтары немесе аймақтық ережелер. Саны роман Fahrenheit 451-ге сілтеме.

RFC 7725 ↗
500

Ішкі сервер қатесі

Сервер күтпеген жағдайға тап болды.

Сервердің қателіктерін сатыратын жинақы. Орындалмайтын сәтсіздік, дәлдеме қатесі және т. б. сервер логын тексеріңіз.

RFC 9110 ↗
501

Өндіру іске асырылмайды

Сервер сұралған eszközkelésті қолдамайды.

Мысалы, сервер HTTP әдістемесін танымайды. Өндіру ішінде өте сирек — жиі 405 көресіз.

RFC 9110 ↗
502

Қалыс шлюз

Сервер шлюз ретінде арқалықты серверден қалыс жауап алды.

Микрошындықтар сәулегелеу ішінде әдетті. Сіздің жүктеме балансыңыз немесе кері прокси-сервері арқалықты сервістен қалыс жауап алды.

RFC 9110 ↗
503

Қызмет ұрындай алмайды

Сервер уақытша сұраудың өндіру мүмкін емес.

Немесе техникалық қызмет немесе шамамалы іс жүргіземі. Жауап Retry-After тақтасын болуы керек. Жиі мөлік кезінде қайтарылады.

RFC 9110 ↗
504

Шлюз уақыты аяқталды

Шлюз сервері арқалықты жауаптың құтуынан сыршайды.

Арқалықты қызмет біске сәйір болмайды. Арқалықты қызмет сау және уақыттың конфигурациясын тексеріңіз.

RFC 9110 ↗
505

HTTP нұсқасы қолдана аймақты емес

Сервер сұраудан пайдаланылған HTTP нұсқасын қолдамайды.

Сұраудың HTTP нұсқасының негіз сервер тарапынан қолданылмайды. Заманауи клиенттері біліктіңдіктік көрілмейді.

RFC 9110 ↗
506

Ортасы да келісітіріңіз

Сервердің мазмұны келісітіру қателік.

Мазмұнның прозрачты келісімі циклқа түсті: сонарт мөлік өзі kelісітіріңіз үшін іске асырылды. Сервер конфигурациясын қатесін болдырмайды.

RFC 2295 ↗
507

Сақталу жеткіліксіз

Сервер дискі орны аяқталды.

WebDAV-балдығыны санаты болса да кейде жалпы серверлер тарапынан пайдаланылады. Сервер сақталау шектеулері салтына сұраудың сақтауы мүмкін емес.

RFC 4918 ↗
508

Циклы табылды

Сервер сұрауды өндіру кезінде шексіз циклды анықтады.

WebDAV: Depth: infinity сұрауын өндіруге циклқа түсті (мысалы, циклдық байланыстар). Іс-әрекет зағрударлана сыршайды.

RFC 5842 ↗
510

Кеңейтілмеген емес

Сұрауға қосымша кеңейтуі қажет.

Ескі HTTP ұлғайтуы шегелеуінен: сервер бұл сұраудың өндіруінен бұрын қосымша ақпараттарға қажет. Заманауи веб-де нәтижелік әмес.

RFC 2774 ↗
511

Сәттік аутентификациялау қажет

Клиент сәттік қол жеткізуге аутентификациялану керек.

Түтін ақ порталдарының (отель/әуежай WiFi) әлдеудеуінде пайдаланылады, пайдаланушы ішінара сайттарға қол жеткізбес бұрын сәттік логині ғана керекті.

RFC 6585 ↗

Жиі қолданылуы

  • API дизайн үшін АнықтамасыREST API-лерін дизайн кезінде, әрбір жауап үшін дұрыс күй коды таңдаңыз.
  • Ақау Кодларды Тез Қарап шығыңызСағызың зағыңба HTTP ақау қайтарғанда, болмайды шынында не болатынды қарап шығыңыз.
  • HTTP Күй Кодтарын ҮйреніңізHTTP және REST үйренген студент және өндіктіктер үшін түйіндеме анықтамасы.
  • Өндіктік Өндіктік Жылдам АнықтамасыӨндіктік өндіктіктік ісінде, әрбір күй коды не болатынды тез қарап шығыңыз.
  • API құжаттамасы үшін сілтемеAPI құжаттамасын жазғанда, қайтарылатын статус кодтарының негіз деген сипаттамаларына сілтеме беріңіз.

Қалай жұмыс істейді

Бұл құрал — барлық бес класты (1xx–5xx) қамтитын 63 HTTP күй кодының бекітілген іздеу кестесі айналасында құрылған клиент жағындағы анықтама, әрқайсысы оны анықтайтын RFC санымен белгіленген. Серверлік шақыру, сыртқы API немесе желілік сұрау жоқ — барлық сүзу мен көрсету JavaScript-тің кірістірілген массив пен жол әдістерін пайдаланып браузерде жүреді.

  1. 1
    Іздеу кестесі жүктелді
    63 IANA-тіркелген күй кодының толық жиынтығы осы құралда JavaScript массиві ретінде тікелей енгізілген, әр жазба сандық кодты, канондық ағылшын атауын, санат класын және оны анықтайтын нақты RFC-ты (мысалы, көптеген HTTP/1.1 кодтары үшін RFC 9110, 429 Too Many Requests үшін RFC 6585, 418 I'm a Teapot үшін RFC 2324) алып жүреді.
  2. 2
    Сүзу жадта жұмыс істейді
    Теру немесе санат сүзгісін таңдау кезінде, JavaScript-тің Array.filter жадтағы тізімде жұмыс істейді, сұранысыңызды String.includes пайдаланып күй код санына, канондық атауға және қысқа мен ұзын сипаттама жолдарының екеуіне де сәйкестендіреді — кідіріс жоқ, серверге барып-келу жоқ.
  3. 3
    Мәліметтер RFC сілтемесімен кеңейеді
    Әр нәтиже HTML details/summary элементі ретінде өңделеді. Жазбаны кеңейту толық түсіндірмені және rfc-editor.org-тағы беделді RFC-ке тікелей сілтемені ашады, сондықтан кез келген код үшін нақты спецификация мәтінін оқи аласыз.
  4. 4
    Терең сілтемелер мен буферге көшіру
    Жазбаны ашу URL хэшін код санына жаңартады (мысалы, #404), бетті бөлісуге және бетбелгіге қосуға ыңғайлы етеді. Көшіру түймесі канондық жолды (мысалы, '404 Not Found') браузердің navigator.clipboard API-ы арқылы буферге жазады.

Байланысты құралдар

Жиі қойылатын сұрақтар