Swell Ecommerce API筛选无数据返回,求正确使用方式
Swell API 自定义产品属性筛选解决方案
两种正确的筛选格式(根据属性类型调整)
情况1:属性值直接存储为字符串(如"yes"/"no")
用这个标准格式尝试,Swell的嵌套属性筛选需要严格对应层级:
https://api.swell.store/products?where[active][$eq]=true&where[attributes][featured_products][$eq]=yes
也可以简化写法(Swell支持省略$eq直接匹配等于条件):
https://api.swell.store/products?where[active]=true&where[attributes][featured_products]=yes
情况2:属性是后台设置的「选项类型」(如下拉/单选)
这是最容易踩的坑——Swell后台添加的选项类属性,实际存储的是选项的内部ID,而非你看到的"yes"/"no"显示文本。解决步骤:
- 先调用
/products/attributes接口,获取featured_products属性的所有选项,找到"yes"对应的ID - 用该ID替换筛选值,示例:
https://api.swell.store/products?where[active][$eq]=true&where[attributes][featured_products][$eq]=abc123
必做排查项
- 核对属性名:确保后台的自定义属性名完全是
featured_products(注意大小写、单复数,避免拼写错误) - 查看实际数据:调用单个产品的详情接口,检查
attributes字段里featured_products的真实值,确认不是null或其他格式 - 调整分页参数:如果结果为空,添加
limit=100参数,避免因默认分页限制导致看不到匹配结果
内容的提问来源于stack exchange,提问作者Gaurav
相关产品推荐
相关产品推荐

