如何测试带过滤参数的API？Postman中filters[is_true]传参问题

方法1：按文档标注的扁平参数格式传递（优先尝试） #

• 在Postman的Params页面，直接新增两个查询参数：
  • 第一个Key填token，Value填你拿到的有效token值（必填项缺失会直接导致过滤逻辑不触发）
  • 第二个Key填filters[is_true]，Value填0或1即可，不需要额外加$filter前缀
• 可以切换到Postman请求面板的「Code」选项，查看生成的原始请求URL，正确编码后的格式应为：
  https://something/get-list?token=你的实际token&filters%5Bis_true%5D=1
  其中%5B %5D是方括号的标准URL编码，属于正常情况

方法2：嵌套JSON格式传递（方法1无效时尝试） #

部分后端框架会期望接收JSON结构的filters参数，可按以下方式操作：

查询参数传递 #

• Key填filters，Value填{"is_true": 1}

请求体传递（接口支持POST请求时用） #

• 把请求方法改成POST，在Body页选择raw → JSON，填入以下内容：

{
  "token": "你的实际token",
  "filters": {
    "is_true": 1
  }
}

常见问题排查 #

• 确认请求方法和文档要求一致，错把POST请求用GET发送会导致参数不被识别
• 确认参数拼写完全匹配文档，包括大小写、下划线等细节
• 如果以上操作都无效，可直接对接开发确认该接口过滤器参数的解析规则，不同服务端框架的参数接收逻辑没有统一标准

内容的提问来源于stack exchange，提问作者user3529643