优惠券管理
优惠券管理接口用于创建和管理优惠券。所有接口都需要管理员权限。
获取优惠券列表
获取优惠券列表。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| page | integer | 否 | 页码，默认1 |
| size | integer | 否 | 每页数量 |
| status | string | 否 | 优惠券状态 |
| type | string | 否 | 优惠券类型 |
GET /admin/coupon/list?page=1&size=10&status=active
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
获取优惠券详情
获取指定优惠券的详细信息。请求参数
GET /admin/coupon/coupon_123
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
创建优惠券
创建新的优惠券。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| code | string | 是 | 优惠券代码 |
| name | string | 是 | 优惠券名称 |
| description | string | 否 | 优惠券描述 |
| type | string | 是 | 优惠券类型 |
| value | number | 是 | 优惠券面值 |
| min_amount | number | 否 | 最低使用金额 |
| start_time | string | 是 | 开始时间 |
| end_time | string | 是 | 结束时间 |
| usage_limit | integer | 否 | 使用次数限制 |
POST /admin/coupon
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
{
"code": "SPRING2024",
"name": "春季优惠券",
"description": "春季特惠活动优惠券",
"type": "discount",
"value": 15,
"min_amount": 100,
"start_time": "2024-03-01T00:00:00Z",
"end_time": "2024-03-31T23:59:59Z",
"usage_limit": 500
}
更新优惠券
更新指定优惠券的信息。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| id | string | 是 | 优惠券ID |
| name | string | 否 | 优惠券名称 |
| description | string | 否 | 优惠券描述 |
| status | string | 否 | 优惠券状态 |
| min_amount | number | 否 | 最低使用金额 |
| end_time | string | 否 | 结束时间 |
| usage_limit | integer | 否 | 使用次数限制 |
PUT /admin/coupon/coupon_124
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
{
"name": "更新后的优惠券",
"description": "这是更新后的优惠券描述",
"status": "active",
"usage_limit": 1000
}
删除优惠券
删除指定的优惠券。请求参数
DELETE /admin/coupon/coupon_124
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
错误码说明
错误码说明
| 错误码 | 说明 |
|---|
| 400 | 请求参数错误 |
| 401 | 未授权或令牌无效 |
| 403 | 权限不足（需要管理员权限） |
| 404 | 优惠券不存在 |
| 422 | 请求参数验证失败 |
| 500 | 服务器错误 |
