Кодове за състояние на 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