商品专辑筛选器-当前过滤属性
商品专辑 - 获取当前已启用的筛选条件
接口信息
- 接口地址:
{your-site-url}/api/skill/product-collection/get-current-filter-attr - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址,如https://your-domain.com/apimanager666 - 请求方式:
GET - 说明: 此接口用于获取当前店铺已启用的商品专辑筛选条件。与 商品专辑筛选器-全部过滤属性 不同,此接口只返回当前店铺配置中已勾选启用的筛选条件。
认证
请求头中需要携带 skill-access-token:
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
无参数。
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/product-collection/get-current-filter-attr' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功;code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [
{
"Label": "Price",
"key": "price"
},
{
"Label": "Vendor",
"key": "vendor"
}
],
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码,200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Array[Object] | 当前已启用的筛选条件列表 |
data 子项字段
| 字段 | 类型 | 说明 |
|---|---|---|
key |
string | 筛选条件标识。price = 按价格筛选,vendor = 按供应商/品牌筛选,availability = 按库存可用性筛选 |
Label |
string | 前台展示的标签名称 |
注意事项
- 此接口返回的是当前店铺配置中已开启的筛选条件,可能少于 商品专辑筛选器-全部过滤属性 返回的 3 个全部条件
- 通过筛选条件设置(set)接口可调整哪些条件启用
- 系统默认仅支持 3 个筛选条件,如需更多筛选属性需使用 Typesense 插件实现