Коды стану HTTP альбо коды адказу згрупаваны ў пяць катэгорый. 1 × × інфармацыйная інфармацыя, 2 × × поспех, 3 × выпадкі перанакіравання, 4 × выпадковыя памылкі кліента, 5 × выпадковыя памылкі сервера.
Гэты пост змяшчае поўны спіс кодаў стану HTTP з кароткім апісаннем найбольш распаўсюджаных кодаў адказаў.
Калі мы праводзім тэставанне API, звычайна першае, што мы правяраем на адказ ад выкліку API, - гэта код стану. Вельмі важна, каб мы былі знаёмыя па меншай меры з найбольш распаўсюджанымі кодамі стану, каб мы маглі хутчэй выяўляць праблемы.
Клас кода стану 1xx (інфармацыйны) указвае на прамежкавы адказ для паведамлення пра стан злучэння або прагрэсу запыту да завяршэння запытанага дзеяння і адпраўкі канчатковага адказу.
Клас кода стану 2xx (паспяховы) паказвае, што запыт кліента быў паспяхова атрыманы, зразуметы і прыняты.
Код стану 200 (OK) паказвае, што запыт быў выкананы. Карысная нагрузка, адпраўленая ў адказе 200, залежыць ад спосабу запыту.
Код стану 201 (Створаны) указвае на тое, што запыт быў выкананы і прывёў да стварэння аднаго або некалькіх новых рэсурсаў.
Код стану 204 (Без змесціва) паказвае на тое, што сервер паспяхова выканаў запыт і што няма дадатковага змесціва для адпраўкі ў целе карыснай нагрузкі адказу.
Звязаныя:
Клас кода стану 3xx (перанакіраванне) паказвае, што для выканання запыту карыстальніцкі агент павінен распачаць далейшыя дзеянні.
Код стану 301 (Перамешчаны назаўсёды) паказвае, што мэтаваму рэсурсу быў прызначаны новы пастаянны URI, і любыя будучыя спасылкі на гэты рэсурс павінны выкарыстоўваць адзін з прыкладзеных URI.
Код стану 302 (знойдзены) паказвае, што мэтавы рэсурс часова знаходзіцца пад іншым URI.
Клас кода стану 4xx (памылка кліента) паказвае на памылку кліента.
Код стану 400 (дрэнны запыт) паказвае на тое, што сервер не можа альбо не будзе апрацоўваць запыт з-за чагосьці, што ўспрымаецца як памылка кліента (напрыклад, няправільны сінтаксіс запыту).
Код стану 401 (несанкцыянаваны) паказвае, што запыт не быў ужыты, бо ў ім адсутнічаюць сапраўдныя ўліковыя дадзеныя для аўтэнтыфікацыі мэтавага рэсурсу.
Код стану 403 (Забаронены) паказвае, што сервер зразумеў запыт, але адмаўляецца яго аўтарызаваць.
Код стану 404 (не знойдзены) указвае на тое, што зыходны сервер не знайшоў бягучае прадстаўленне для мэтавага рэсурсу альбо не гатовы раскрываць яго наяўнасць.
Код стану 405 (метад не дазволены) паказвае, што метад, атрыманы ў радку запыту, вядомы зыходным серверам, але не падтрымліваецца мэтавым рэсурсам.
Код стану 415 (непадтрымоўваны тып носьбіта) паказвае, што першапачатковы сервер адмаўляецца абслугоўваць запыт, паколькі карысная нагрузка знаходзіцца ў фармаце, які не падтрымліваецца гэтым метадам на мэтавым рэсурсе. Праблема з фарматам можа быць звязана з указаным у запыце тыпам змесціва альбо кадаваннем змесціва альбо ў выніку непасрэднага праверкі дадзеных.
Клас кода стану 5xx (памылка сервера) паказвае, што сервер ведае, што памыліўся альбо не здольны выканаць запытаны спосаб.
Код стану 500 (унутраная памылка сервера) паказвае, што сервер сутыкнуўся з нечаканай умовай, якая перашкодзіла яму выканаць запыт.
Код стану 502 (Bad Gateway) паказвае, што сервер, дзейнічаючы ў якасці шлюза або проксі-сервера, атрымаў няправільны адказ ад уваходнага сервера, да якога ён звяртаўся пры спробе выканаць запыт.
Код стану 503 (служба недаступная) указвае на тое, што сервер у цяперашні час не можа апрацаваць запыт з-за часовай перагрузкі альбо планавага тэхнічнага абслугоўвання, якое, верагодна, будзе палегчана пасля пэўнай затрымкі.
Код стану 504 (Час чакання шлюза) паказвае, што сервер, дзейнічаючы ў якасці шлюза або проксі-сервера, не атрымаў своечасовага адказу ад вышэйстаячага сервера, да якога яму трэба было атрымаць доступ для завяршэння запыту.
Даведка: