参数类型 📋

  • 查询参数(Query Parameters):用于过滤或定制请求的数据,例如 /docs/parameters?sort=desc
    查询参数
  • 路径参数(Path Parameters):直接嵌入URL路径中的变量,如 /docs/parameters/{id}
    路径参数
  • 请求头参数(Request Headers):携带元信息,如 Content-Type: application/json
    请求头参数

使用示例 💡

  1. 查询用户数据:
    GET /docs/parameters?user_id=123
  2. 获取分页列表:
    GET /docs/parameters?page=2&limit=10
  3. 通过路径指定资源:
    GET /docs/parameters/456

注意事项 ⚠️

  • 所有参数需遵循API规范
  • 敏感信息请通过请求体(Body)传递而非URL
  • 更多参数配置可参考高级用法
参数示意图