8.1 商品列表
TIP
统一 Metadata：appid: ****, 其中 appid 值为商户appid。
请求示例
json
{
"current_page": 1,
"per_page": 20
}参数说明
- 页码模式: 使用
current_page,per_page字段 - 游标模式: 使用
cursor,limit字段, 该模式目前仅支持特定设备
| 字段名 | 默认值 | 是否必须 | 描述 |
|---|---|---|---|
| current_page | 1 | - | 第几页, 默认: 1 |
| per_page | - | - | 每页大小, 最大值: 20 |
| cursor | - | - | 游标值 (预留字段) |
| limit | - | - | 每次取多少条 (预留字段) |
返回结果
json
{
"data": [
{
"media": [
"https://dash.awish.vip/storage/p50v9ggY/617dd1e8-877c-4132-9a42-26322366464d.jpg",
"https://dash.awish.vip/storage/p50v9ggY/778ac0da-62bb-41c5-a5b9-a70192e4fe58.jpg"
],
"attributes": [
{
"label_value": [],
"id": "1",
"label_name": "stand_weight",
"immutable": false
}
],
"id": "110",
"name": "茅台",
"price": "1.00",
"content": "<p>茅台</p>",
"updated_at": "2025-07-30 06:49:29",
"unit": {
"id": "2",
"name": "pcs",
"display_name": "个",
"multiplier": 1,
"base_unit": "个",
"description": "基础计数单位",
"immutable": true
},
"age_verification_enabled": false,
"is_tax_exempt": false,
"description": "茅台",
"original_price": "999.00",
"slug": "obe8GBUWo0rr",
"age_verification_min": "0",
"tax_rate": "0.01",
"thumb": "https://dash.awish.vip/storage/p50v9ggY/617dd1e8-877c-4132-9a42-26322366464d.jpg"
}
],
"total": "2",
"current_page": "1",
"per_page": "20"
}商品信息(good)
| 字段名 | 默认值 | 描述 |
|---|---|---|
| id | 1 | 主键 |
| media | [] | 产品图片 |
| attributes | [] | 产品属性 |
| name | - | 产品名称 |
| price | - | 产品价格 |
| content | - | 产品详情 |
| updated_at | - | 更新时间 |
| unit | - | 产品单位 |
| age_verification_enabled | - | 是否开启年龄限制 |
| is_tax_exempt | - | 是否免税 |
| description | - | 产品描述 |
| original_price | - | 原价 |
| slug | - | 产品 slug |
| age_verification_min | - | 年龄限制 |
| tax_rate | - | 税率 |
| thumb | - | 缩略图 |