模块说明
attribute 提供"内容属性"读取接口：按模块（module）+ 内容 ID（item_id）返回该内容的属性及属性值列表（常用于商品规格选择、内容参数展示）。
鉴权级别：可选。
接口一览
| 方法 |
URL |
鉴权 |
说明 |
| GET |
/api/attribute |
可选 |
读取属性列表 |
请求参数
| 参数 |
必填 |
说明 |
module |
是 |
模块英文名（如 product） |
item_id |
是 |
内容 ID（必须大于 0） |
category_id |
否 |
分类 ID（影响分类级属性配置） |
rec |
否 |
固定 list（内部约定；传其它值返回空列表） |
GET /api/attribute?module=product&item_id=12&category_id=2
响应
{
"code": "OK",
"message": "",
"data": {
"attribute_list": [
{
"attribute_id": 1,
"name": "颜色",
"value_list": [
{ "attribute_value_id": 11, "value": "红色" },
{ "attribute_value_id": 12, "value": "蓝色" }
]
}
]
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 字段 |
说明 |
attribute_list[].attribute_id |
属性 ID |
attribute_list[].name |
属性名 |
attribute_list[].value_list[] |
属性值列表（attribute_value_id + value） |
错误与边界
| 场景 |
响应 |
module 非字母或 item_id <= 0 |
400 INVALID_PARAMS |
| 属性模块未启用 |
200 OK，attribute_list: []（空） |
注意事项
- 商品详情页的规格选择建议先调本接口拿全量属性与值，再结合
product/attribute_list 做级联联动；
- 属性值 ID（
attribute_value_id）在下单/加购时用于定位具体 SKU（以订单文档为准）。