原生移动开发 / 系统课时
HTTP、REST 与 JSON
HTTP、REST 与 JSON
Android 调接口时,真正需要读懂的是一组稳定的协议约定:客户端怎样描述请求,服务器怎样用状态码和 Header 回答,以及响应体怎样用 JSON 表达数据。本篇用一次真实 GET 请求把 HTTP、REST 与 JSON 串起来。
学习目标
- 能说清请求方法、URL、Header、Body 与状态码各自的职责
- 能用 REST 的资源视角理解常见接口路径与请求方法
- 能读懂 JSON 对象、数组和字段类型,并判断响应是否适合继续解析
从一次请求看 HTTP
一次 HTTP 交互由请求和响应组成。请求至少包含方法与 URL,还可以携带 Header 和 Body;响应则包含状态码、Header 与响应体。Android 网络库只是帮你构造、发送和解析这些内容,协议本身并没有消失。

先在终端直接请求一个公开示例接口,这能把 Android 代码之外的协议问题单独验证出来。
curl -s -w "\nHTTP %{http_code}\n" https://jsonplaceholder.typicode.com/posts/1预期输出如下。JSON 的缩进可能不同,但状态码应为 200,对象中的 id 应为 1。
{
"userId": 1,
"id": 1,
"title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
"body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"
}
HTTP 200这里的 GET 表示读取资源,URL 指向具体资源 /posts/1。如果接口要求身份认证,通常会通过 Authorization 等请求 Header 传递;创建或修改资源时,请求 Body 常承载 JSON。
用方法和状态码判断结果
常见方法可以按意图记忆:GET 读取,POST 创建或触发处理,PUT 整体替换,PATCH 部分更新,DELETE 删除。具体语义仍以服务端接口契约为准,不能只根据方法名猜测业务行为。
状态码先告诉你 HTTP 层结果。2xx 表示请求已被服务器成功处理,4xx 通常表示请求本身存在问题或权限不足,5xx 表示服务器处理失败。常见的 200 是成功返回,201 常用于创建成功,400 是请求错误,401 是未认证,404 是资源不存在,500 是服务器内部错误。
用 REST 的资源视角组织接口
REST 不是数据格式,而是一种常见的接口设计风格。核心思路是把服务器上的对象看成资源,用 URL 标识资源,再用 HTTP 方法表达操作。例如 /posts 表示文章集合,/posts/1 表示编号为 1 的文章。
同一个资源路径可以配合不同方法表达不同意图:GET /posts/1 获取文章,PATCH /posts/1 修改部分字段,DELETE /posts/1 删除文章。理解接口时应同时看资源路径与请求方法,而不是只记住某个具体函数名。
读懂 JSON 数据结构
JSON 最常见的两种容器是对象与数组。对象用键值对描述一个实体,数组保存一组有顺序的值;字段值可以是字符串、数字、布尔值、对象、数组或 null。上面的响应体就是一个对象,其中 userId 和 id 是数字,title 和 body 是字符串。
Android 中通常会把 JSON 映射为 Kotlin 数据类,因此字段名和类型必须与接口返回能够对应。例如服务端把 id 从数字改成对象,客户端仍按 Int 解析时就可能失败。真正排查网络问题时,应按“状态码 → Content-Type 等响应 Header → 原始响应体 → 数据模型”的顺序检查,而不是一看到解析异常就立即修改数据类。