对接Bubble.io时，如何为Mantis REST API自定义字段设置动态过滤

正确的API调用格式 #

你之前用的custom_field_id和custom_field_value不是查询过滤的正确参数，这才导致返回大量不符合预期的工单。Mantis REST API的查询过滤需要用filter前缀的结构化参数，针对自定义字段的正确调用格式如下：

/mantis/api/rest/issues?filter[custom_fields][][id]=59&filter[custom_fields][][value]=paying&page_size=10&page=1

参数说明 #

• filter[custom_fields][][id]：填你已确认的自定义字段ID（这里是59）
• filter[custom_fields][][value]：填要匹配的字段值，可按需替换为returning、closed等值
• page_size和page参数保留用于分页控制

之前调用无效的原因 #

custom_field_id和custom_field_value一般是创建或更新工单时指定自定义字段的参数，不是查询过滤条件。用它们查询时，API会返回所有包含该自定义字段的工单（不管值是什么），这就是你得到83条结果的原因。

额外注意事项 #

• 确认你的MantisBT版本支持该过滤格式（推荐2.20及以上版本，REST API功能更完善）
• 如果是下拉选类型的自定义字段，要保证传入的value和后台配置的选项值完全一致（包括大小写、空格等）
• 如需同时过滤多个自定义字段，可重复添加filter[custom_fields][]结构，示例：

  /mantis/api/rest/issues?filter[custom_fields][][id]=59&filter[custom_fields][][value]=paying&filter[custom_fields][][id]=60&filter[custom_fields][][value]=high&page_size=10&page=1
  

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