HTTP Code 实战

857 / 5,000

很多http code 并不是马上就可以匹配的. 这里给出一些实际遇到的问题

不受支持的安全性(Unsupported Security)

通常用于指示不受支持的安全协议或配置的 HTTP 状态代码是 426 需要升级。根据 HTTP/1.1 规范，当服务器拒绝使用当前协议执行请求但在客户端升级到不同协议后可能愿意这样做时，将使用 426 状态代码。当客户端尝试访问需要更安全的协议或加密方案的资源时，例如当服务器需要 HTTPS 而不是 HTTP 时，通常会使用此响应代码。因此，如果服务器由于不受支持的安全性而拒绝请求，则可以使用 426 Upgrade Required 状态代码以及解释错误原因的消息以及有关如何升级到所需协议或配置的说明进行响应.

缺少访问令牌 (Missing Access Token)

通常用于指示 API 请求中缺少访问令牌的 HTTP 状态代码是 401 Unauthorized。根据 HTTP/1.1 规范，401 状态代码表示客户端缺少所请求资源的适当身份验证凭据。在需要访问令牌的 API 上下文中，401 响应将指示请求缺少所需的访问令牌或提供的访问令牌无效。因此，如果客户端在未提供有效访问令牌的情况下尝试访问受保护的 API 端点，则可以使用 401 未授权状态代码以及解释错误原因的消息以及有关如何获取和获取的说明进行响应。使用有效的访问令牌。

Endpoint未定义范围 (Undefined Scope For Endpoint)

当 API 客户端尝试访问需要访问令牌不具备的特定范围或权限的端点时，通常用于指示此错误的 HTTP 状态代码是 403 Forbidden。

根据HTTP/1.1规范，403状态码表示服务器理解请求但拒绝授权。 在需要特定范围或权限才能访问特定端点的 API 上下文中，403 响应将指示提供的访问令牌不具有访问所请求端点的必要范围。

因此，如果客户端尝试访问没有所需范围的端点，则可以使用 403 Forbidden 状态代码进行响应，并附上解释错误原因的消息以及有关如何获取访问令牌的说明 必要范围。 该消息还可以提供有关端点所需范围的详细信息，以及用户为获得所需访问权限可以采取的操作。

无效令牌(Invalid Token)

通常用于指示无效访问令牌的 HTTP 状态代码是 401 Unauthorized。

根据 HTTP/1.1 规范，401 状态代码表示客户端缺少所请求资源的适当身份验证凭据，在需要访问令牌的 API 上下文中，401 响应表示提供的访问令牌无效 .

因此，如果客户端尝试使用无效的访问令牌访问 API 端点，则可以使用 401 未授权状态代码以及解释错误原因的消息以及有关如何获取和获取的说明进行响应。 使用有效的访问令牌。 该消息还可以提供有关令牌发生的错误类型的详细信息，例如令牌是否已过期或已被撤销，以及用户可以采取哪些措施来获取新的有效令牌。

缺少会话数据 (Missing Session Data)

通常用于指示所需会话数据丢失的 HTTP 状态代码是 400 Bad Request。

根据 HTTP/1.1 规范，当服务器由于客户端错误（例如请求参数丢失或格式错误）而无法或不会处理请求时，将使用 400 状态代码。 在依赖会话数据的 Web 应用程序的上下文中，400 响应表示客户端发送的请求缺少某些必需的会话数据。

因此，如果客户端试图在不提供所需会话数据的情况下访问 Web 应用程序，则可以使用 400 Bad Request 状态代码进行响应，并附上一条解释错误原因的消息以及有关如何提供请求的说明。 所需的会话数据。 该消息还可以提供有关丢失的会话数据类型的详细信息，以及用户可以采取哪些措施来获取或更新它。

无法从 URL 下载，没有正文返回 (Could not download from URL, no body returned)

通常用于指示请求的资源不可用或服务器无法从提供的 URL 下载的 HTTP 状态代码是 404 Not Found。

根据HTTP/1.1规范，404状态码表示服务器找不到请求的资源，是客户端错误响应码。 在无法从 URL 下载资源的上下文中，404 响应将指示该资源在指定的 URL 上不可用。

因此，如果服务器尝试从 URL 下载资源并收到不包含正文的响应，则可以使用 404 Not Found 状态代码以及解释错误原因的消息进行响应， 有关如何检查 URL 并重试的说明。 该消息还可以提供有关无法下载的资源的其他详细信息，例如资源类型和大小，以及用户可以采取的解决问题的任何步骤。

无法下载 (Could not download)

怎么下载不了如果服务器尝试下载资源并遇到错误或无法下载资源，通常使用的 HTTP 状态代码是 502 Bad Gateway。根据 HTTP/1.1 规范，502 状态码表示服务器从上游服务器或网关接收到无效响应，这阻止了它完成请求。在下载失败的情况下，502 响应表示服务器正在充当网关或代理，无法从上游服务器检索资源。因此，如果服务器尝试下载资源并遇到错误，则返回 502 Bad Gateway 状态代码以及解释错误原因的消息以及用户可以尝试的任何步骤都是合适的再次。该消息还可以提供有关无法下载的资源的其他详细信息，例如资源类型和大小，以及用户可以采取的解决问题的任何步骤。

空内容错误 Empty Body

通常用于指示响应主体为空或在预期响应主体但未收到时发生错误的 HTTP 状态代码是 204 No Content 或 400 Bad Request，具体取决于具体情况。

如果请求格式正确并且服务器出于正当理由无法提供响应主体，例如当客户端请求不需要响应主体或旨在返回空响应的操作时，它将是 适合使用 204 No Content 状态代码进行响应。 204 状态码表示服务器已成功处理请求，但响应正文中没有要发回的附加信息。

另一方面，如果客户端需要响应主体而服务器由于客户端错误而无法提供响应主体，例如当客户端请求了无效资源或未提供有效请求参数时，这将是合适的 以 400 Bad Request 状态代码响应。 400 状态代码表示由于客户端错误（例如请求参数丢失或格式错误），服务器无法或不会处理请求。

在这两种情况下，与状态代码一起返回的消息应提供有关错误的其他信息，包括可能有助于客户端解决问题的任何错误代码或消息。

无法将文件放入 S3 (Unable to put file in S3)

将文件上传到 Amazon S3 时通常用于指示错误的 HTTP 状态代码是 500 Internal Server Error。

根据 Amazon S3 文档，500 Internal Server Error 响应表示在处理请求时出现内部服务器错误，例如无法将文件写入磁盘或传输过程中出现网络错误。 在将文件上传到 S3 的上下文中，500 响应表示服务器由于内部错误而无法处理请求。

因此，如果在将文件上传到 S3 时发生错误，则可以使用 500 Internal Server Error 状态代码进行响应，并附上一条消息，解释错误原因以及用户可以采取的重试步骤 . 该消息还可以提供有关发生的错误的其他详细信息，例如可能有助于客户端解决问题的任何错误代码或消息。

找不到请求计时器 (Cannot find request timer)

当未找到或无法定位请求计时器时，通常用于指示错误的 HTTP 状态代码是 500 Internal Server Error。

根据错误发生的上下文，请求计时器可以指跟踪请求持续时间的计时器，或者指跟踪会话或令牌过期的计时器。 在任何一种情况下，如果计时器无法定位或无法正常工作，则可能表明内部服务器错误导致服务器无法完成请求。

因此，如果服务器在尝试定位或使用请求计时器时遇到错误，则可以使用 500 Internal Server Error 状态代码进行响应，并附上一条解释错误原因的消息以及用户需要执行的任何步骤 可以拿去再试一次。 该消息还可以提供有关发生的错误的其他详细信息，例如可能有助于客户端解决问题的任何错误代码或消息。

维护中 (Under maintain)

通常用于表示网站或 Web 服务正在维护或暂时不可用的 HTTP 状态代码是 503 Service Unavailable。

根据HTTP/1.1规范，503状态码表示由于服务器临时过载或维护，服务器当前无法处理请求。 这可能包括服务器正在进行维护或更新，或者遇到临时流量或请求过载的情况。

因此，如果网站或 Web 服务正在进行维护或暂时不可用，则可以使用 503 服务不可用状态代码进行响应，并附上解释错误原因的消息以及有关预期持续时间的任何信息。 维护或停机。 该消息还可以提供有关维护的任何相关详细信息，例如在维护期间哪些特定服务或功能将不可用，以及用户可以采取的稍后重试的任何步骤。