Enum curs::StatusCode

pub enum StatusCode {
    Continue,
    SwitchingProtocols,
    Processing,
    Ok,
    Created,
    Accepted,
    NonAuthoritativeInformation,
    NoContent,
    ResetContent,
    PartialContent,
    MultiStatus,
    AlreadyReported,
    ImUsed,
    MultipleChoices,
    MovedPermanently,
    Found,
    SeeOther,
    NotModified,
    UseProxy,
    TemporaryRedirect,
    PermanentRedirect,
    BadRequest,
    Unauthorized,
    PaymentRequired,
    Forbidden,
    NotFound,
    MethodNotAllowed,
    NotAcceptable,
    ProxyAuthenticationRequired,
    RequestTimeout,
    Conflict,
    Gone,
    LengthRequired,
    PreconditionFailed,
    PayloadTooLarge,
    UriTooLong,
    UnsupportedMediaType,
    RangeNotSatisfiable,
    ExpectationFailed,
    ImATeapot,
    UnprocessableEntity,
    Locked,
    FailedDependency,
    UpgradeRequired,
    PreconditionRequired,
    TooManyRequests,
    RequestHeaderFieldsTooLarge,
    InternalServerError,
    NotImplemented,
    BadGateway,
    ServiceUnavailable,
    GatewayTimeout,
    HttpVersionNotSupported,
    VariantAlsoNegotiates,
    InsufficientStorage,
    LoopDetected,
    NotExtended,
    NetworkAuthenticationRequired,
    Unregistered(u16),
}

An HTTP status code (status-code in RFC 7230 et al.).

This enum contains all common status codes and an Unregistered extension variant. It allows status codes in the range [0, 65535], as any u16 integer may be used as a status code for XHR requests. It is recommended to only use values between [100, 599], since only these are defined as valid status codes with a status class by HTTP.

If you encounter a status code that you do not know how to deal with, you should treat it as the x00 status code—e.g. for code 123, treat it as 100 (Continue). This can be achieved with self.class().default_code():

let status = StatusCode::Unregistered(123);
assert_eq!(status.class().default_code(), StatusCode::Continue);

IANA maintain the Hypertext Transfer Protocol (HTTP) Status Code Registry which is the source for this enum (with one exception, 418 I'm a teapot, which is inexplicably not in the register).

Variants

Continue	100 Continue [RFC7231, Section 6.2.1]
SwitchingProtocols	101 Switching Protocols [RFC7231, Section 6.2.2]
Processing	102 Processing [RFC2518]
Ok	200 OK [RFC7231, Section 6.3.1]
Created	201 Created [RFC7231, Section 6.3.2]
Accepted	202 Accepted [RFC7231, Section 6.3.3]
NonAuthoritativeInformation	203 Non-Authoritative Information [RFC7231, Section 6.3.4]
NoContent	204 No Content [RFC7231, Section 6.3.5]
ResetContent	205 Reset Content [RFC7231, Section 6.3.6]
PartialContent	206 Partial Content [RFC7233, Section 4.1]
MultiStatus	207 Multi-Status [RFC4918]
AlreadyReported	208 Already Reported [RFC5842]
ImUsed	226 IM Used [RFC3229]
MultipleChoices	300 Multiple Choices [RFC7231, Section 6.4.1]
MovedPermanently	301 Moved Permanently [RFC7231, Section 6.4.2]
Found	302 Found [RFC7231, Section 6.4.3]
SeeOther	303 See Other [RFC7231, Section 6.4.4]
NotModified	304 Not Modified [RFC7232, Section 4.1]
UseProxy	305 Use Proxy [RFC7231, Section 6.4.5]
TemporaryRedirect	307 Temporary Redirect [RFC7231, Section 6.4.7]
PermanentRedirect	308 Permanent Redirect [RFC7238]
BadRequest	400 Bad Request [RFC7231, Section 6.5.1]
Unauthorized	401 Unauthorized [RFC7235, Section 3.1]
PaymentRequired	402 Payment Required [RFC7231, Section 6.5.2]
Forbidden	403 Forbidden [RFC7231, Section 6.5.3]
NotFound	404 Not Found [RFC7231, Section 6.5.4]
MethodNotAllowed	405 Method Not Allowed [RFC7231, Section 6.5.5]
NotAcceptable	406 Not Acceptable [RFC7231, Section 6.5.6]
ProxyAuthenticationRequired	407 Proxy Authentication Required [RFC7235, Section 3.2]
RequestTimeout	408 Request Timeout [RFC7231, Section 6.5.7]
Conflict	409 Conflict [RFC7231, Section 6.5.8]
Gone	410 Gone [RFC7231, Section 6.5.9]
LengthRequired	411 Length Required [RFC7231, Section 6.5.10]
PreconditionFailed	412 Precondition Failed [RFC7232, Section 4.2]
PayloadTooLarge	413 Payload Too Large [RFC7231, Section 6.5.11]
UriTooLong	414 URI Too Long [RFC7231, Section 6.5.12]
UnsupportedMediaType	415 Unsupported Media Type [RFC7231, Section 6.5.13]
RangeNotSatisfiable	416 Range Not Satisfiable [RFC7233, Section 4.4]
ExpectationFailed	417 Expectation Failed [RFC7231, Section 6.5.14]
ImATeapot	418 I'm a teapot [curiously, not registered by IANA, but RFC2324]
UnprocessableEntity	422 Unprocessable Entity [RFC4918]
Locked	423 Locked [RFC4918]
FailedDependency	424 Failed Dependency [RFC4918]
UpgradeRequired	426 Upgrade Required [RFC7231, Section 6.5.15]
PreconditionRequired	428 Precondition Required [RFC6585]
TooManyRequests	429 Too Many Requests [RFC6585]
RequestHeaderFieldsTooLarge	431 Request Header Fields Too Large [RFC6585]
InternalServerError	500 Internal Server Error [RFC7231, Section 6.6.1]
NotImplemented	501 Not Implemented [RFC7231, Section 6.6.2]
BadGateway	502 Bad Gateway [RFC7231, Section 6.6.3]
ServiceUnavailable	503 Service Unavailable [RFC7231, Section 6.6.4]
GatewayTimeout	504 Gateway Timeout [RFC7231, Section 6.6.5]
HttpVersionNotSupported	505 HTTP Version Not Supported [RFC7231, Section 6.6.6]
VariantAlsoNegotiates	506 Variant Also Negotiates [RFC2295]
InsufficientStorage	507 Insufficient Storage [RFC4918]
LoopDetected	508 Loop Detected [RFC5842]
NotExtended	510 Not Extended [RFC2774]
NetworkAuthenticationRequired	511 Network Authentication Required [RFC6585]
Unregistered	A status code not in the IANA HTTP status code registry or very well known