获取指定活动的详细信息,包含关联的 SKU 信息。
请求地址
{域名地址}/api/activity/detail
说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/activity/detail
请求语法
GET {域名地址}/api/activity/detail?{参数}
请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
请求参数
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 活动 ID |
响应头
此接口仅涉及公共相应头。更多信息,请参见公共请求头(Common Request Headers)。
返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码 |
| msg | string | 错误原因说明 |
| data | object | 活动详情 |
data 结果 item 参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | int | 活动 ID |
| name | string | 活动名称 |
| title | string | 活动标题 |
| description | string | 活动描述 |
| goods_id | int | 关联商品 ID |
| type | int | 活动类型 |
| price | int | 活动价格,单位分 |
| original_price | int | 原始价格,单位分 |
| start_time | int | 活动开始时间戳 |
| end_time | int | 活动结束时间戳 |
| status | int | 活动状态 |
| min_quantity | int | 最小购买数量 |
| max_quantity | int | 最大购买数量 |
| can_use_coupon | bool | 是否可使用优惠券 |
| stock | int | 活动库存 |
| sold_count | int | 已售数量 |
| skus | object[] | 活动 SKU 列表 |
| created_time | int | 创建时间戳 |
| updated_time | int | 更新时间戳 |
skus 活动 SKU 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | int | SKU ID |
| activity_id | int | 活动 ID |
| sku_id | int | 商品 SKU ID |
| price | int | 活动价格,单位分 |
| stock | int | 库存数量 |
| created_time | int | 创建时间戳 |
使用示例
请求示例
GET /api/activity/detail?id=1 HTTP/1.1
Host: your-domain.com
Content-Type: application/json
响应示例
{
"code": 0,
"data": {
"id": 1,
"name": "限时特惠",
"title": "夏季大促",
"description": "全场商品8折优惠",
"goods_id": 123,
"type": 0,
"price": 2999,
"original_price": 3999,
"start_time": 1607308159,
"end_time": 1607912759,
"status": 1,
"min_quantity": 1,
"max_quantity": 10,
"can_use_coupon": true,
"stock": 100,
"sold_count": 15,
"skus": [
{
"id": 1,
"activity_id": 1,
"sku_id": 789,
"price": 3299,
"stock": 50,
"created_time": 1607308159
}
],
"created_time": 1607308159,
"updated_time": 1662717106
},
"msg": ""
}
错误代码
| 错误码 | 说明 |
|---|---|
| 0 | OK |
| -1 | 活动不存在 |