Last updated
Last updated
Кодовете за състояние на 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
Сървърът не е готов да обработи заявката. Често срещаните причини са сървър, който не работи за поддръжка или е претоварен.