httpStatusDevMessage top-level property

Implementation

Map<int, String> get httpStatusDevMessage => const {
      // 1xx - Informational
      100:
          'Client should continue with request. Server received request headers and client should proceed with body.',
      101:
          'Server is switching protocols as requested by client Upgrade header.',
      102:
          'Server received and is processing request, but no response is available yet.',
      103:
          'Server is likely to send a final response with the headers included in this interim response.',

      // 2xx - Success
      200: 'Request successfully processed. Response includes payload.',
      201:
          'Resource successfully created. Response includes Location header or payload with resource URI.',
      202:
          'Request accepted for processing but not completed. Processing may occur asynchronously.',
      203:
          'Request processed via proxy that modified the underlying response data.',
      204:
          'Request processed successfully but response intentionally empty. Common for DELETE operations.',
      205:
          'Request processed. Client should reset document view. No response payload.',
      206: 'Partial content delivered as per Range header requirements.',
      207: 'Multi-Status response. Payload contains XML MultiStatus (WebDAV).',
      208:
          'DAV binding member already enumerated in previous part of (207) Multi-Status.',
      226: 'Server fulfilled GET request, response is delta encoding result.',

      // 3xx - Redirection
      300:
          'Multiple representations available. Respond to Accept header or provide choice.',
      301:
          'Resource permanently moved. Update all references to new Location header URI.',
      302:
          'Resource temporarily moved. Maintain original URI for future requests.',
      303:
          'Response found at different URI. Use GET for redirect regardless of original method.',
      304:
          'Resource not modified since timestamp or ETag in conditional request.',
      305:
          'Resource must be accessed through proxy in Location header (deprecated).',
      306:
          'Status code reserved for future use. Originally meant "Switch Proxy".',
      307:
          'Resource temporarily moved. Maintain method and payload for redirect.',
      308:
          'Resource permanently moved. Maintain method and payload for redirect.',

      // 4xx - Client Errors

      400:
          'Malformed request syntax, invalid request message framing, or deceptive request routing.',
      401:
          'Request lacks valid authentication credentials. Check Authorization header.',
      402:
          'Payment required. Reserved for future use. Check API documentation.',
      403:
          "Server understood request but refuses to authorize. Authentication won't help.",
      404: 'Resource not found at this location. Check URI path and method.',
      405:
          'HTTP method not allowed for resource. Check Allow header for valid methods.',
      406: 'Resource cannot generate response matching Accept headers.',
      407: 'Proxy authentication required. Check Proxy-Authenticate header.',
      408: 'Server timed out waiting for complete request from client.',
      409:
          'Request conflicts with current resource state. Common in PUT/POST/DELETE.',
      410: 'Resource permanently removed. Similar to 404 but more definitive.',
      411: 'Content-Length header required. Check request headers.',
      412:
          'Precondition in headers failed. Check If-Match/If-None-Match/If-Modified-Since.',
      413:
          'Request payload larger than server willing to process. Check Content-Length.',
      414: 'Request URI longer than server will interpret. Shorten URI.',
      415: 'Media type in Content-Type or Content-Encoding not supported.',
      416: 'Range header value invalid for resource. Check Content-Range.',
      417: 'Expectation in Expect header cannot be met by server.',
      418: 'Request refused - server is a teapot 🫖.',
      421:
          'Request directed to server unable to produce response. Check Host header.',
      422: 'Request well-formed but semantically invalid. Common in WebDAV.',
      423: 'Resource locked. Check WebDAV lock-token header.',
      424: 'Request failed due to failure of previous request (WebDAV).',
      425:
          'Server unwilling to risk processing request that might be replayed.',
      426: 'Client should upgrade to required protocol. Check Upgrade header.',
      428: 'Precondition Required. Request should be conditional.',
      429: 'Too Many Requests. Check Rate-Limit headers and implement backoff.',
      431: 'Request header fields too large. Reduce header size.',
      451: 'Resource unavailable for legal reasons. May include explanation.',
      499: 'Client closed connection before server finished response.',

      // 5xx - Server Errors
      500:
          'Server encountered unexpected condition preventing request fulfillment.',
      501: 'Server does not support functionality required to fulfill request.',
      502:
          'Invalid response received from upstream server while acting as gateway.',
      503:
          'Server temporarily unable to handle request due to overload or maintenance.',
      504: 'Gateway timeout waiting for response from upstream server.',
      505: 'HTTP version in request not supported by server.',
      506: 'Server has internal configuration error with content negotiation.',
      507: 'Server unable to store representation needed to complete request.',
      508: 'Server detected infinite loop while processing WebDAV request.',
      510: 'Further extensions to request required for server to fulfill it.',
      511: 'Client needs to authenticate to gain network access.',
      599:
          'Network connection timeout error occurred while server processing request.',
    };