优惠券-创建

接口信息

• 接口地址: {your-site-url}/api/skill/coupon/create
• 基础 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/create' \
--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,
    "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,
    "prerequisite_quantity": "",
    "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": {
        "color": "blue",
        "timeType": 1,
        "backgroundLeft": "rgba(255,72,72,100)",
        "backgroundRight": "rgba(255,13,125,100)",
        "fontTip": "rgba(255,255,255,100)",
        "timeBg": "rgba(255,243,203,100)",
        "timeFont": "rgba(0,0,0,100)",
        "couponBg": "rgba(255,248,227,100)",
        "couponFont": "rgba(233,5,73,100)",
        "couponBtLeft": "rgba(255,139,2,100)",
        "couponBtRight": "rgba(255,109,4,100)",
        "couponBtFont": "rgba(255,255,255,100)",
        "copyColor": "rgba(255,109,4,100)"
    }
}'

返回结果

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

成功响应

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

返回字段说明

注意事项

1. banner_image 完整图片url，或者相对路径。如果是相对路径，需要先通过 得到网站基础URL 获取 attachment_url，然后拼接得到完整 URL：attachment_url + banner_image
2. ends_at 为空字符串时表示不限时，返回时值为 0
3. entitled_product_ids 中 variant_ids 为空数组时表示该商品的全部变体适用
4. copywriting 为前台 UI 配色配置，可根据主题自定义颜色值