{
  "code": 0,
  "data": {
    "id": 42,
    "name": "Ada",
    "email": "ada@example.com",
    "created_at": "2026-07-01T10:00:00Z"
  }
}
# 分页:page 从 1 开始,size 默认 20,最大 100
GET /users?page=2&size=20

# 过滤:status=active 的用户
GET /users?status=active

# 排序:按创建时间倒序
GET /users?sort=-created_at
{
  "data": [],
  "pagination": {
    "page": 2,
    "size": 20,
    "total": 153,
    "total_pages": 8
  }
}
# 带查询参数的 GET
curl "https://api.example.com/v1/users?page=1&size=10"

# POST 创建资源
curl -X POST https://api.example.com/v1/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Ada", "email": "ada@example.com"}'

# 查看响应头(状态码、缓存策略等)
curl -i https://api.example.com/v1/users/42

# 删除资源
curl -X DELETE https://api.example.com/v1/users/42
