卷曲

curl 从终端发送请求并打印响应：使用 -X 指定请求方法，使用 -H 指定请求头，使用 -d 指定请求体，使用 -i 指定响应头。由于 curl 命令会详细列出请求的每个部分，因此它已成为共享请求的标准方式——在文档、错误报告以及每个浏览器开发者工具的"Copy as cURL"选项中都如此。

工作原理

-d 表示 POST 请求，除非您设置了 -H "Content-Type: application/json"。-L 表示跟踪重定向，-v 显示完整的请求过程（包括 TLS），--fail 表示 curl 在收到 4xx 或 5xx 错误时返回非零退出代码，以便控制脚本的执行。请求体用单引号括起来可以防止 shell 解析它。

误解

curl 和浏览器发送的是同一个请求。浏览器会添加 cookie、源地址、CORS 预检请求以及自身的 User-Agent；而 curl 只发送你写入的内容。如果一个请求在 curl 中可以成功，但在浏览器中却失败了，这通常是 CORS 或 cookie 的问题，而不是 API 本身的 bug。

点击这里试试

每个端点的“试用”面板都会生成您配置的请求的 curl 命令，工具部分的 curl 转换器会将任何 curl 命令转换为九种语言的代码。

相关内容

• curl 到代码转换器
• What CORS is

资料来源

• cURL documentation

其他术语

• CORS — 决定一个源上的 JavaScript 是否可以读取另一个源的响应的浏览器规则。
• REST API — 将系统建模为可寻址资源的 API，可通过标准 HTTP 方法进行操作。
• API 端点 — 一个 URL 加上一个 HTTP 方法——客户端可以调用的最小 API 单元。
• 查询参数 — URL 中问号后面的键值对，用于过滤、排序、分页或调整端点返回的内容。
• 路径参数 — URL 路径中的可变部分，例如/orders/42中的 42，用于标识一个特定的资源。
• HTTP 标头 — 每个请求和响应都会发送名称-值元数据，与请求体分开。

阅读英文版

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

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