跳转到内容

后端与数据 · DEFINED TERM

HTTP 状态码

用三位数字概括一次 HTTP 请求的处理结果。

你可能会这样说“未登录要返回 401,不要所有失败都返回 200。”

VISUAL EXAMPLE

先看懂它怎么工作

容易误解状态码不能代替面向用户的错误说明
更准确区分成功、客户端错误和服务端错误

MECHANISM

运行机制

  1. 服务端处理
  2. 选择状态类别
  3. 返回状态码与错误正文

USE WHEN

适合这样用

区分成功、客户端错误和服务端错误

NOT FOR

不要这样理解

状态码不能代替面向用户的错误说明

TELL YOUR AGENT

可直接发给 Agent

请按“HTTP 状态码”的概念处理这个需求:未登录要返回 401,不要所有失败都返回 200。。先说明实现边界,再给出可检查的结果。

ACCEPTANCE

怎么确认它真的做好了

常见分支状态码语义正确,前端按状态处理且日志可定位

OFFICIAL SOURCES

官方来源