提示:把 URL 片段用花括号包起来(
{userId})即可作为路径参数管理;生成的代码会随每次编辑即时刷新。GET/HEAD 请求会忽略请求体。生成的文件上传使用 cURL 的
@file 风格或其他语言的占位符 —— 真实文件请在自己的代码中附加。跨源发送由
REST API 客户端处理(请遵守服务器的 CORS 策略);要反向解析已有命令请用
cURL 命令转换器。
HTTP 方法详解
选择不同方法时,生成的 cURL / Node / Python / PowerShell 代码会随之变化。以下是每个动词对你正在构建的请求的含义:
GET — 获取资源的表示。它不应改变服务器状态,生成的请求通常没有请求体。读取、搜索与列表类接口请用 GET。
POST — 提交数据以创建新资源或触发动作。请求体会成为生成代码中的载荷(cURL 的 --data-raw、Node/Python 的 body 参数等)。POST 不是幂等的:发送两次可能创建两个资源。
PUT — 完整替换现有资源。在请求体中发送完整对象;省略的字段可能被视为空。生成的代码会把整个请求体发送到确切的 URL。
PATCH — 只更新你提供的字段。请求体携带部分变更集,因此只编辑一两个值时,生成的请求比 PUT 更小。
DELETE — 删除 URL 处的资源。它是幂等的且通常没有请求体,因此生成的代码是只带请求头的简单删除调用。
HEAD — 只请求响应头,不要响应体。生成的代码看起来像 GET,但只返回 Content-Length、Last-Modified 或 Content-Type 等元数据,节省带宽。
OPTIONS — 探测服务器对某个 URL 允许什么,或模拟 CORS 预检。响应头(例如 Access-Control-Allow-Methods)会显示允许的动词。OPTIONS 通常没有请求体。
容易混淆: HEAD 与 GET — 生成的请求很相似,但 HEAD 不返回响应体。PUT 与 PATCH — PUT 会整体重写资源;PATCH 只修改你提交的字段。