HTTP 请求场景示例
HTTP 请求场景速查：GET/POST/PUT/DELETE 等方法的典型接口示例。
纯浏览器本地运行，数据不上传服务器
| 请求 | 场景 | 说明 |
|---|---|---|
GET / | 获取首页 | 浏览器访问 |
GET /api/users?page=1 | 分页查询 | 列表接口 |
POST /api/login | 登录 | 提交账号密码 |
POST /api/users | 创建用户 | 提交 JSON 数据 |
PUT /api/users/1 | 整体更新 | 替换整个资源 |
PATCH /api/users/1 | 部分更新 | 只改个别字段 |
DELETE /api/users/1 | 删除 | 删除资源 |
HEAD /large.zip | 检查资源 | 只看响应头 |
OPTIONS /api | 预检请求 | CORS 探测 |
GET /api/search?q=abc | 搜索 | 查询参数传关键词 |
POST /api/upload | 文件上传 | multipart 表单 |
GET /api/download?id=1 | 文件下载 | 返回文件流 |
GET /api/export.csv | 导出 CSV | 服务端生成文件 |
POST /api/refresh | 刷新令牌 | 换新 token |
GET /api/profile | 获取个人资料 | 需 Authorization |
POST /api/verify | 验证码校验 | 提交验证码 |
使用说明
- 速查 REST API 典型请求场景与方法选择。
- 搜索支持按请求或场景过滤。
- 接口设计、学习 RESTful、联调参考。
常见问题
PUT 和 POST 怎么选？
POST 创建新资源（非幂等），PUT 更新已知资源（幂等）；PUT 常要求客户端提供完整表示。
分页接口怎么设计？
常用 ?page=1&size=20 或 ?offset=0&limit=20；返回 total 字段便于前端分页。