Кодове за състояние на HTTP отговор

Кодовете за състояние на HTTP отговор показват дали конкретна HTTP заявка е изпълнена успешно. Отговорите са групирани в пет класа:

· Information responses (100 – 199)

· Successful responses (200 – 299)

· Redirection messages (300 – 399)

· Client error responses (400 – 499)

· Server error responses (500 – 599)

Някои по-важни кодове за състояние:

КодОписание

Successful responses

200 OK

Заявката е успешна. Резултатното значение на "успех" зависи от HTTP метода:

· GET: Ресурсът е извлечен и предаден в тялото на съобщението.

· HEAD: репрезентационните хедъри са включени в отговора без никакво тяло на съобщението.

· PUT или POST: Ресурсът, описващ резултата от действието, се предава в тялото на съобщението.

· TRACE: Основният текст на съобщението съдържа съобщението за заявка, получено от сървъра.

201 Created

Заявката е успешна и в резултат на това е създаден нов ресурс. Това обикновено е отговорът, изпратен след POST заявки или някои PUT заявки.

Redirection messages

301 Moved Permanently

URL адресът на искания ресурс е променен за постоянно. Новият URL е даден в отговора.

302 Found

Този код на отговор означава, че URI на искания ресурс е променен временно. Допълнителни промени в URI може да бъдат направени в бъдеще. Следователно същият URI трябва да се използва от клиента в бъдещи заявки.

304 Not Modified

Това се използва за целите на кеширането. Той казва на клиента, че отговорът не е бил променен, така че клиентът може да продължи да използва същата кеширана версия на отговора.

Client error responses

400 Bad Request

Сървърът не може или няма да обработи заявката поради нещо, което се възприема като клиентска грешка (напр. неправилен синтаксис на заявка, невалидно рамкиране на съобщение на заявка или измамно маршрутизиране на заявка).

401 Unauthorized

Показва, че клиентската заявка не е завършена, защото липсват валидни идентификационни данни за заявения ресурс.

403 Forbidden

Клиентът няма права за достъп до съдържанието, така че сървърът отказва да предостави искания ресурс. За разлика от 401 Unauthorized, самоличността на клиента е известна на сървъра.

404 Not Found

Сървърът не може да намери искания ресурс. В браузъра това означава, че URL адресът не е разпознат. В API това може също да означава, че крайната точка е валидна, но самият ресурс не съществува. Сървърите могат също да изпратят този отговор вместо 403 Забранено, за да скрият съществуването на ресурс от неоторизиран клиент. Този код за отговор е може би най-известният поради честото му появяване в мрежата.

405 Method Not Allowed

Методът на заявката е известен на сървъра, но не се поддържа от целевия ресурс. Например API може да не позволява извикване на DELETE за премахване на ресурс.

Server error responses

500 Internal Server Error

Сървърът е изпаднал в ситуация, с която не знае как да се справи.

501 Not Implemented

Методът на заявка не се поддържа от сървъра и не може да бъде обработен. Единствените методи, които сървърите трябва да поддържат (и следователно не трябва да връщат този код), са GET и HEAD.

502 Bad Gateway

Този отговор за грешка означава, че сървърът, докато работи като gateway за получаване на отговор, необходим за обработка на заявката, е получил невалиден отговор.

503 Service Unavailable

Сървърът не е готов да обработи заявката. Често срещаните причини са сървър, който не работи за поддръжка или е претоварен.

Last updated