优惠券-关闭

优惠券 - 提前结束优惠券

接口信息

• 接口地址: {your-site-url}/api/skill/coupon/disable
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• 说明: 此接口用于提前结束（禁用）指定优惠券，支持批量操作。执行后优惠券的 ends_at 将被设置为当前时间，活动状态变为已结束。

认证

请求头中需要携带 skill-access-token：

请求参数 (JSON Body)

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/coupon/disable' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": [68]
}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": [],
    "message": "success"
}

返回字段说明

操作效果

1. 优惠券 ends_at 设置为当前时间
2. 优惠券活动状态 activity_status 变为 3（已结束）
3. 用户将无法再使用该优惠券

恢复使用

已关闭的优惠券如需恢复，可通过优惠券-更新 将 ends_at 修改为大于当前时间的值，活动状态 activity_status 将变为 2（进行中）。

注意事项

1. ids 为数组，支持一次提前结束多个优惠券
2. 仅对进行中（activity_status = 2）的优惠券有效