REST API

REST 是一种架构风格，而非规范。REST API 的实践特点包括：系统中的元素都使用 URL，HTTP 方法明确指定了对元素的操作，状态码则反映了事件的发生，并且服务器不会在请求之间维护单个客户端的会话。服务器处理请求所需的一切都随请求一同到达。

工作原理

集合位于路径 ` /characters ，集合中的元素位于/characters/1.请求用于读取，POST 请求用于创建，PUT 请求用于替换，PATCH 请求用于修改，DELETE 请求用于删除。过滤、排序和分页功能依赖于查询字符串。URL 的表示形式是通过 Accept 和 Content-Type 协商确定的，而不是直接嵌入到 URL 中。响应状态是主要结果：如果客户端只读取响应体，就相当于丢失了一半的信息。

误解

有人认为 REST 就意味着通过 HTTP 实现 JSON。事实并非如此——REST 本身并没有规定必须使用 JSON，而且很多基于 HTTP 的 JSON API 根本不符合 RESTful 规范（例如，一个接受请求体中包含操作名称的 ` /api端点，实际上就是披着 REST 外衣的 RPC）。RESTful 的本质区别在于资源是可寻址的，并且方法本身就包含动词。

点击这里试试

该目录包含 39 个 REST API，共计 338 个端点。其中任何一个都足以满足基本需求；协议实验室 (Protocol Lab) 则是专门围绕大多数模拟 API 所忽略的 HTTP 部分构建的。

相关内容

• 入门指南
• 安全且等效的方法

资料来源

• HTTP semantics — RFC 9110
• OpenAPI Initiative

其他术语

• 安全且等效的方法 — HTTP 方法的两个独立属性决定了客户端可以重试哪些方法。
• API 端点 — 一个 URL 加上一个 HTTP 方法——客户端可以调用的最小 API 单元。
• 查询参数 — URL 中问号后面的键值对，用于过滤、排序、分页或调整端点返回的内容。
• 路径参数 — URL 路径中的可变部分，例如/orders/42中的 42，用于标识一个特定的资源。
• HTTP 标头 — 每个请求和响应都会发送名称-值元数据，与请求体分开。
• HTTP 状态码 — 每个 HTTP 响应开头的三位数，在响应体之前，表示发生了什么。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日