http-status-codes.yml

# HTTP Status codes
# @link https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
#
# This is a useful porting of status codes taken from Wikipedia

# 2xx Success
#
# This class of status codes indicates the action requested by the client was received, understood, accepted, and processed successfully
# ----------
200:
    status:
        type: "200 OK"
    stats:
        is_error: false
        rfc:
    message:
        code: 200
        title: "OK"
        detail: "HTTP requests successful"
201:
    status:
        type: "201 Created"
    stats:
        is_error: false
        rfc:
    message:
        code: 201
        title: "Created"
        detail: "The request has been fulfilled, resulting in the creation of a new resource"
202:
    status:
        type: "202 Accepted"
    stats:
        is_error: false
        rfc:
    message:
        code: 202
        title: "Accepted"
        detail: "The request has been accepted for processing, but the processing has not been completed"
203:
    status:
        type: "203 Non-Authoritative Information"
    stats:
        is_error: false
        rfc:
    message:
        code: 203
        title: "Non-Authoritative Information"
        detail: "The server is a transforming proxy that received a 200 OK from its origin, but is returning a modified version of the origin's response"
204:
    status:
        type: "204 No Content"
    stats:
        is_error: false
        rfc:
    message:
        code: 204
        title: "No Content"
        detail: "The server successfully processed the request and is not returning any content"
205:
    status:
        type: "205 Reset Content"
    stats:
        is_error: false
        rfc:
    message:
        code: 205
        title: "Reset Content"
        detail: "The server successfully processed the request, but is not returning any content. This response requires that the requester reset the document view"
206:
    status:
        type: "206 Partial Content"
    stats:
        is_error: false
        rfc:
            code: 7233,
            url: "https://tools.ietf.org/html/rfc7233"
    message:
        code: 206
        title: "Partial Content"
        detail: "The server is delivering only part of the resource due to a range header sent by the client"
207:
    status:
        type: "207 Multi-Status"
    stats:
        is_error: false
        rfc:
            code: 4918,
            url: "https://tools.ietf.org/html/rfc4918"
    message:
        code: 207
        title: "Multi-Status"
        detail: "The message body that follows is an XML message and can contain a number of separate response codes, depending on how many sub-requests were made"
208:
    status:
        type: "208 Already Reported"
    stats:
        is_error: false
        rfc:
            code: 5842,
            url: "https://tools.ietf.org/html/rfc5842"
    message:
        code: 208
        title: "Already Reported"
        detail: "The members of a DAV binding have already been enumerated in a previous reply to this request, and are not being included again"
226:
    status:
        type: "226 IM Used"
    stats:
        is_error: false
        rfc:
            code: 3229,
            url: "https://tools.ietf.org/html/rfc3229"
    message:
        code: 226
        title: "IM Used"
        detail: "The server has fulfilled a request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance"

# 3xx Redirection
#
# This class of status code indicates the client must take additional action to complete the request.
# Many of these status codes are used in URL redirection
# A user agent may carry out the additional action with no user interaction only if the method used in the second request is GET or HEAD.
# A user agent may automatically redirect a request.
# A user agent should detect and intervene to prevent cyclical redirects
# ----------
300:
    status:
        type: "300 Multiple Choices"
    stats:
        is_error: true
        rfc:
    message:
        code: 300
        title: "Multiple Choices"
        detail: "Indicates multiple options for the resource from which the client may choose"
301:
    status:
        type: "301 Moved Permanently"
    stats:
        is_error: true
        rfc:
    message:
        code: 301
        title: "Moved Permanently"
        detail: "This and all future requests should be directed to the given URI"
302:
    status:
        type: "302 Found"
    stats:
        is_error: true
        rfc:
            code: 1945,
            url: "https://tools.ietf.org/html/rfc1945"
    message:
        code: 302
        title: "Moved Temporarily"
        detail: "Moved Temporarily"
303:
    status:
        type: "303 See Other"
    stats:
        is_error: true
        rfc:
    message:
        code: 303
        title: "See Other"
        detail: "The response to the request can be found under another URI using a GET method"
304:
    status:
        type: "304 Not Modified"
    stats:
        is_error: true
        rfc:
            code: 7232,
            url: "https://tools.ietf.org/html/rfc7232"
    message:
        code: 304
        title: "Not Modified"
        detail: "The resource has not been modified since the version specified by the request headers If-Modified-Since or If-None-Match"
305:
    status:
        type: "305 Use Proxy"
    stats:
        is_error: true
        rfc:
    message:
        code: 305
        title: "Use Proxy"
        detail: "The requested resource is available only through a proxy, the address for which is provided in the response"
306:
    status:
        type: "306 Switch Proxy"
    stats:
        is_error: true
        rfc:
    message:
        code: 306
        title: "Switch Proxy"
        detail: "Subsequent requests should use the specified proxy"
307:
    status:
        type: "307 Temporary Redirect"
    stats:
        is_error: true
        rfc:
    message:
        code: 307
        title: "Temporary Redirect"
        detail: "The request should be repeated with another URI; however, future requests should still use the original URI"
308:
    status:
        type: "308 Permanent Redirect"
    stats:
        is_error: true
        rfc:
            code: 7538,
            url: "https://tools.ietf.org/html/rfc7538"
    message:
        code: 308
        title: "Permanent Redirect"
        detail: "The request and all future requests should be repeated using another URI"

# 4xx Client Error
#
# The 4xx class of status codes is intended for situations in which the client seems to have errored.
# Except when responding to a HEAD request, the server should include an entity containing an explanation of the error situation, and whether it is a temporary or permanent condition.
# These status codes are applicable to any request method.
# User agents should display any included entity to the user
# ----------
400:
    status:
        type: "400 Bad Request"
    stats:
        is_error: true
        rfc:
    message:
        code: 400
        title: "Bad Request"
        detail: "The server cannot or will not process the request due to an apparent client error"
401:
    status:
        type: "401 Unauthorized"
    stats:
        is_error: true
        rfc:
            code: 7235,
            url: "https://tools.ietf.org/html/rfc7235"
    message:
        code: 401
        title: "Unauthorized"
        detail: "The response must include a WWW-Authenticate header field containing a challenge applicable to the requested resource"
403:
    status:
        type: "403 Forbidden"
    stats:
        is_error: true
        rfc:
    message:
        code: 403
        title: "Forbidden"
        detail: "The request was a valid request, but the server is refusing to respond to it. The user might be logged in but does not have the necessary permissions for the resource"
404:
    status:
        type: "404 Not Found"
    stats:
        is_error: true
        rfc:
    message:
        code: 404
        title: "Not Found"
        detail: "The requested resource could not be found but may be available in the future. Subsequent requests by the client are permissible."
405:
    status:
        type: "405 Method Not Allowed"
    stats:
        is_error: true
        rfc:
    message:
        code: 405
        title: "Method Not Allowed"
        detail: "A request method is not supported for the requested resource"
406:
    status:
        type: "406 Not Acceptable"
    stats:
        is_error: true
        rfc:
    message:
        code: 406
        title: "Not Acceptable"
        detail: "The requested resource is capable of generating only content not acceptable according to the Accept headers sent in the request"
407:
    status:
        type: "407 Proxy Authentication Required"
    stats:
        is_error: true
        rfc:
            code: 7235,
            url: "https://tools.ietf.org/html/rfc7235"
    message:
        code: 407
        title: "Proxy Authentication Required"
        detail: "The client must first authenticate itself with the proxy"
408:
    status:
        type: "408 Request Timeout"
    stats:
        is_error: true
        rfc:
    message:
        code: 408
        title: "Request Timeout"
        detail: "The client did not produce a request within the time that the server was prepared to wait. The client MAY repeat the request without modifications at any later time"
409:
    status:
        type: "409 Conflict"
    stats:
        is_error: true
        rfc:
    message:
        code: 409
        title: "Conflict"
        detail: "The request could not be processed because of conflict in the request, such as an edit conflict between multiple simultaneous updates"
410:
    status:
        type: "410 Gone"
    stats:
        is_error: true
        rfc:
    message:
        code: 410
        title: "Gone"
        detail: "The resource requested is no longer available and will not be available again"
411:
    status:
        type: "411 Length Required"
    stats:
        is_error: true
        rfc:
    message:
        code: 411
        title: "Length Required"
        detail: "The request did not specify the length of its content, which is required by the requested resource"
412:
    status:
        type: "412 Precondition Failed"
    stats:
        is_error: true
        rfc:
            code: 7232,
            url: "https://tools.ietf.org/html/rfc7232"
    message:
        code: 412
        title: "Precondition Failed"
        detail: "The server does not meet one of the preconditions that the requester put on the request"
413:
    status:
        type: "413 Payload Too Large"
    stats:
        is_error: true
        rfc:
            code: 7231,
            url: "https://tools.ietf.org/html/rfc7231"
    message:
        code: 413
        title: "Payload Too Large"
        detail: "Request Entity Too Large"
414:
    status:
        type: "414 URI Too Long"
    stats:
        is_error: true
        rfc:
            code: 7231,
            url: "https://tools.ietf.org/html/rfc7231"
    message:
        code: 414
        title: "URI Too Long"
        detail: "The URI provided was too long for the server to process"
415:
    status:
        type: "415 Unsupported Media Type"
    stats:
        is_error: true
        rfc:
    message:
        code: 415
        title: "Unsupported Media Type"
        detail: "The request entity has a media type which the server or resource does not support"
416:
    status:
        type: "416 Range Not Satisfiable"
    stats:
        is_error: true
        rfc:
            code: 7233,
            url: "https://tools.ietf.org/html/rfc7233"
    message:
        code: 416
        title: "Range Not Satisfiable"
        detail: "The client has asked for a portion of the file, but the server cannot supply that portion"
417:
    status:
        type: "417 Expectation Failed"
    stats:
        is_error: true
        rfc:
    message:
        code: 417
        title: "Expectation Failed"
        detail: "The server cannot meet the requirements of the Expect request-header field"
418:
    status:
        type: "418 I'm a teapot"
    stats:
        is_error: true
        rfc:
            code: 2324,
            url: "https://tools.ietf.org/html/rfc2324"
    message:
        code: 418
        title: "I'm a teapot"
        detail: "The RFC 2324 specifies this code should be returned by teapots requested to brew coffee"
421:
    status:
        type: "421 Misdirected Request"
    stats:
        is_error: true
        rfc:
            code: 7540,
            url: "https://tools.ietf.org/html/rfc7540"
    message:
        code: 421
        title: "Misdirected Request"
        detail: "The request was directed at a server that is not able to produce a response"
422:
    status:
        type: "422 Unprocessable Entity"
    stats:
        is_error: true
        rfc:
            code: 4918,
            url: "https://tools.ietf.org/html/rfc4918"
    message:
        code: 422
        title: "Unprocessable Entity"
        detail: "The request was well-formed but was unable to be followed due to semantic errors"
423:
    status:
        type: "423 Locked"
    stats:
        is_error: true
        rfc:
            code: 4918,
            url: "https://tools.ietf.org/html/rfc4918"
    message:
        code: 423
        title: "Locked"
        detail: "The resource that is being accessed is locked"
424:
    status:
        type: "424 Failed Dependency"
    stats:
        is_error: true
        rfc:
            code: 4918,
            url: "https://tools.ietf.org/html/rfc4918"
    message:
        code: 424
        title: "Failed Dependency"
        detail: "The request failed due to failure of a previous request"
426:
    status:
        type: "426 Upgrade Required"
    stats:
        is_error: true
        rfc:
    message:
        code: 426
        title: "Upgrade Required"
        detail: "The client should switch to a different protocol such as TLS/1.0, given in the Upgrade header field"
428:
    status:
        type: "428 Precondition Required"
    stats:
        is_error: true
        rfc:
            code: 6585,
            url: "https://tools.ietf.org/html/rfc6585"
    message:
        code: 428
        title: "Precondition Required"
        detail: "The origin server requires the request to be conditional"
429:
    status:
        type: "429 Too Many Requests"
    stats:
        is_error: true
        rfc:
            code: 6585,
            url: "https://tools.ietf.org/html/rfc6585"
    message:
        code: 429
        title: "Too Many Requests"
        detail: "The user has sent too many requests in a given amount of time. Intended for use with rate-limiting schemes"
431:
    status:
        type: "431 Request Header Fields Too Large"
    stats:
        is_error: true
        rfc:
            code: 6585,
            url: "https://tools.ietf.org/html/rfc6585"
    message:
        code: 431
        title: "Request Header Fields Too Large"
        detail: "The server is unwilling to process the request because either an individual header field, or all the header fields collectively, are too large"
440:
    status:
        type: "440 Login Time-out"
    stats:
        is_error: true
        rfc:
    message:
        code: 440
        title: "Login Time-out"
        detail: "The client's session has expired and must log in again"
444:
    status:
        type: "444 No Response"
    stats:
        is_error: true
        rfc:
    message:
        code: 444
        title: "No Response"
        detail: "Used to indicate that the server has returned no information to the client and closed the connection"
449:
    status:
        type: "449 Retry With"
    stats:
        is_error: true
        rfc:
    message:
        code: 449
        title: "Retry With"
        detail: "The client's session has expired and must log in again"
451:
    status:
        type: "451 Unavailable For Legal Reasons"
    stats:
        is_error: true
        rfc:
            code: 7725,
            url: "https://tools.ietf.org/html/rfc7725"
    message:
        code: 451
        title: "Unavailable For Legal Reasons"
        detail: "The server cannot honour the request because the user has not provided the required information"
495:
    status:
        type: "495 SSL Certificate Error"
    stats:
        is_error: true
        rfc:
    message:
        code: 495
        title: "SSL Certificate Error"
        detail: "An expansion of the 400 Bad Request response code, used when the client has provided an invalid client certificate"
496:
    status:
        type: "496 SSL Certificate Required"
    stats:
        is_error: true
        rfc:
    message:
        code: 496
        title: "SSL Certificate Required"
        detail: "An expansion of the 400 Bad Request response code, used when a client certificate is required but not provided"
497:
    status:
        type: "497 HTTP Request Sent to HTTPS Port"
    stats:
        is_error: true
        rfc:
    message:
        code: 497
        title: "HTTP Request Sent to HTTPS Port"
        detail: "An expansion of the 400 Bad Request response code, used when the client has made a HTTP request to a port listening for HTTPS requests"
498:
    status:
        type: "498 Invalid Token"
    stats:
        is_error: true
        rfc:
    message:
        code: 498
        title: "Invalid Token"
        detail: "Returned by ArcGIS for Server. A code of 498 indicates an expired or otherwise invalid token"
499:
    status:
        type: "499 Token Required"
    stats:
        is_error: true
        rfc:
    message:
        code: 499
        title: "Token Required"
        detail: "Returned by ArcGIS for Server. A code of 499 indicates that a token is required but was not submitted"

# 5xx Server Error
#
# The server failed to fulfill an apparently valid request.
# Response status codes beginning with the digit "5" indicate cases in which the server is aware that it has encountered an error or is otherwise incapable of performing the request.
# Except when responding to a HEAD request, the server should include an entity containing an explanation of the error situation, and indicate whether it is a temporary or permanent condition.
# Likewise, user agents should display any included entity to the user.
# These response codes are applicable to any request method.
# ----------
500:
    status:
        type: "500 Internal Server Error"
    stats:
        is_error: true
        rfc:
    message:
        code: 500
        title: "Internal Server Error"
        detail: "A generic error message, given when an unexpected condition was encountered and no more specific message is suitable"
501:
    status:
        type: "501 Not Implemented"
    stats:
        is_error: true
        rfc:
    message:
        code: 501
        title: "Not Implemented"
        detail: "The server either does not recognize the request method, or it lacks the ability to fulfill the request"
502:
    status:
        type: "502 Bad Gateway"
    stats:
        is_error: true
        rfc:
    message:
        code: 502
        title: "Bad Gateway"
        detail: "The server was acting as a gateway or proxy and received an invalid response from the upstream server"
503:
    status:
        type: "503 Service Unavailable"
    stats:
        is_error: true
        rfc:
    message:
        code: 503
        title: "Service Unavailable"
        detail: "The server is currently unavailable (because it is overloaded or down for maintenance). Generally, this is a temporary state"
504:
    status:
        type: "504 Gateway Time-out"
    stats:
        is_error: true
        rfc:
    message:
        code: 504
        title: "Gateway Time-out"
        detail: "The server was acting as a gateway or proxy and did not receive a timely response from the upstream server"
505:
    status:
        type: "505 HTTP Version Not Supported"
    stats:
        is_error: true
        rfc:
    message:
        code: 505
        title: "HTTP Version Not Supported"
        detail: "The server does not support the HTTP protocol version used in the request."
506:
    status:
        type: "506 Variant Also Negotiates"
    stats:
        is_error: true
        rfc:
            code: 2295,
            url: "https://tools.ietf.org/html/rfc2295"
    message:
        code: 506
        title: "Variant Also Negotiates"
        detail: "Transparent content negotiation for the request results in a circular reference"
507:
    status:
        type: "507 Insufficient Storage"
    stats:
        is_error: true
        rfc:
            code: 4918,
            url: "https://tools.ietf.org/html/rfc4918"
    message:
        code: 507
        title: "Insufficient Storage"
        detail: "The server is unable to store the representation needed to complete the request"
508:
    status:
        type: "508 Loop Detected"
    stats:
        is_error: true
        rfc:
            code: 5842,
            url: "https://tools.ietf.org/html/rfc5842"
    message:
        code: 508
        title: "Loop Detected"
        detail: "The server detected an infinite loop while processing the request (sent in lieu of 208 Already Reported)"
509:
    status:
        type: "509 Bandwidth Limit Exceeded"
    stats:
        is_error: true
        rfc:
            code: 5842,
            url: "https://tools.ietf.org/html/rfc5842"
    message:
        code: 509
        title: "Bandwidth Limit Exceeded"
        detail: "The server has exceeded the bandwidth specified by the server administrator"
510:
    status:
        type: "510 Not Extended"
    stats:
        is_error: true
        rfc:
            code: 2774,
            url: "https://tools.ietf.org/html/rfc2774"
    message:
        code: 510
        title: "Not Extended"
        detail: "Further extensions to the request are required for the server to fulfill it"
511:
    status:
        type: "511 Network Authentication Required"
    stats:
        is_error: true
        rfc:
            code: 6585,
            url: "https://tools.ietf.org/html/rfc6585"
    message:
        code: 511
        title: "Network Authentication Required"
        detail: "The client needs to authenticate to gain network access. Intended for use by intercepting proxies used to control access to the network"
598:
    status:
        type: "598 Network read timeout error"
    stats:
        is_error: true
        rfc:
    message:
        code: 598
        title: "Network read timeout error"
        detail: "Used by some HTTP proxies to signal a network read timeout behind the proxy to a client in front of the proxy"
599:
    status:
        type: "599 Network connect timeout error"
    stats:
        is_error: true
        rfc:
    message:
        code: 599
        title: "Network connect timeout error"
        detail: "Used to indicate when the connection to the network times out"