HTTP 与 API 入门：一次请求到底发生了什么

客户端发送请求，服务器返回响应。理解 HTTP 的语义比先背框架更重要：方法说明意图，状态码说明处理结果，响应体承载数据或错误细节。

你会学到什么

• 认识 GET、POST、PATCH、DELETE。

• 正确阅读状态码和响应体。

• 发出第一个可检查错误的请求。

动手步骤

• 阅读接口的 URL、方法、参数和鉴权说明。

• 先用 curl 或 Network 面板观察最小请求。

• 代码中先判断 response.ok。

• 为无权限、空结果和服务端错误提供分支。

最小示例

curl -i https://api.github.com/repos/nodejs/node

容易踩坑的地方

• 200 不一定代表业务成功，还要检查返回字段。

• GET 不该修改数据。

• 不要把 token 放到 URL 中。

完成前检查

• 请求方法和业务语义匹配。

• 错误路径有提示。

• 日志不记录 Authorization 与 Cookie。

延伸阅读

• MDN：HTTP overview：https://developer.mozilla.org/en-US/docs/Web/HTTP/Overview

• MDN：Status codes：https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status