优惠券-更新

优惠券 - 更新优惠券

接口信息

• 接口地址: {your-site-url}/api/skill/coupon/update
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• 说明: 此接口用于更新一张已有的优惠券。需要先获取优惠券详情，修改后提交全量数据。

认证

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

请求参数 (JSON Body)

基本信息

折扣设置

适用商品

最低使用条件

展示设置

copywriting - 文案/UI配色

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/coupon/update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "is_campaign": 1,
    "status": 1,
    "title": "terry coupon",
    "code": "LX4ABQ14",
    "value_type": 1,
    "value": "10.00",
    "usage_count_per_customer": 0,
    "usage_limit": 0,
    "starts_at": "2026-06-03 20:50:03",
    "ends_at": "",
    "product_selection_type": 2,
    "entitled_product_ids": [
        {"product_id": 7042, "variant_ids": []},
        {"product_id": 7041, "variant_ids": []}
    ],
    "entitled_collection_ids": [],
    "minimum_requirements_type": 2,
    "prerequisite_subtotal": "50.00",
    "prerequisite_quantity": 0,
    "product_sort": 1,
    "banner_image": "/product/15/image/2026/05/29/430015af6d7473355e7180b97741e443.png",
    "banner_show_type": 1,
    "is_product_page_show": 1,
    "product_image_height_type": "auto",
    "copywriting": { ... },
    "id": "69"
}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "id": 69,
        "shop_id": 15,
        "status": 1,
        "title": "terry coupon",
        "code": "LX4ABQ14",
        "is_campaign": 1,
        "usage_count": 0,
        "value_type": 1,
        "value": "10.00",
        "usage_count_per_customer": 0,
        "usage_limit": 0,
        "starts_at": "2026-06-03 20:50:03",
        "ends_at": 0,
        "product_selection_type": 2,
        "entitled_product_ids": [
            {"product_id": 7042, "variant_ids": []},
            {"product_id": 7041, "variant_ids": []}
        ],
        "entitled_collection_ids": [],
        "minimum_requirements_type": 2,
        "prerequisite_subtotal": "50.00",
        "prerequisite_quantity": 0,
        "product_sort": 1,
        "banner_image": "/product/15/image/2026/05/29/430015af6d7473355e7180b97741e443.png",
        "banner_show_type": 1,
        "copywriting": { ... },
        "is_product_page_show": 1,
        "product_image_height_type": "auto",
        "created_at": "2026-06-03 20:51:33",
        "updated_at": "2026-06-03 20:51:33"
    },
    "message": "success"
}

返回字段说明

操作流程

此为全量更新接口，建议按以下步骤操作：

1. 调用 优惠券-详细 获取当前优惠券完整数据
2. 在获取到的数据基础上修改需要变更的字段
3. 将完整数据提交到本接口

注意事项

1. 此接口为全量更新，需提交优惠券的全部字段，未传入的字段可能被清空
2. id 为必填，指定要更新的优惠券
3. 字段说明同 优惠券-创建