首页 » 微信公众平台开发:从零基础到ThinkPHP5高性能框架实践 » 微信公众平台开发:从零基础到ThinkPHP5高性能框架实践全文在线阅读

《微信公众平台开发:从零基础到ThinkPHP5高性能框架实践》16.1.3 卡券的创建

关灯直达底部

创建卡券接口是微信卡券的基础接口,用于创建一类新的卡券,获取card_id。创建成功并通过审核后,商家可以通过文档提供的其他接口将卡券下发给用户,每次成功领取,库存数量会相应扣除。

创建卡券的接口如下。


https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN  

创建卡券时,POST数据示例如下。


{    "card":{        "card_type":"GROUPON",        "groupon":{            "base_info":{                "logo_url":"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaH                qkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",                "brand_name":"微信餐厅",                "code_type":"CODE_TYPE_TEXT",                "title":"132元双人火锅套餐",                "color":"Color010",                "notice":"使用时向服务员出示此券",                "service_phone":"020-88888888",                "description":"不可与其他优惠同享 如需团购券发票,请在消费时向商户提出店内均                可使用,仅限堂食",                "date_info":{                    "type":"DATE_TYPE_FIX_TIME_RANGE",                    "begin_timestamp":1397577600,                    "end_timestamp":1472724261                },                "sku":{                    "quantity":500000                },                "get_limit":3,                "use_custom_code":false,                "bind_openid":false,                "can_share":true,                "can_give_friend":true,                "location_id_list":[                    123,                    12321,                    345345                ],                "center_title":"顶部居中按钮",                "center_sub_title":"按钮下方的wording",                "center_url":"www.qq.com",                "custom_url_name":"立即使用",                "custom_url":"http:// www.qq.com",                "custom_url_sub_title":"6个汉字tips",                "promotion_url_name":"更多优惠",                "promotion_url":"http:// www.qq.com",                "source":"大众点评"            },            "advanced_info":{                "use_condition":{                    "accept_category":"鞋类",                    "reject_category":"阿迪达斯",                    "can_use_with_other_discount":true                },                "abstract":{                    "abstract":"微信餐厅推出多种新季菜品,期待您的光临",                    "icon_url_list":[                        "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz                        1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0"                    ]                },                "text_image_list":[                    {                        "image_url":"http:// mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn                        97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6Ijl                        kY9YnDsfw/0",                        "text":"此菜品精选食材,以独特的烹饪方法,最大程度地刺激食客的味蕾"                    },                    {                        "image_url":"http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn                        97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6Ijl                        kY9YnDsfw/0",                        "text":"此菜品迎合大众口味,老少皆宜,营养均衡"                    }                ],                "time_limit":[                    {                        "type":"MONDAY",                        "begin_hour":0,                        "end_hour":10,                        "begin_minute":10,                        "end_minute":59                    },                    {                        "type":"HOLIDAY"                    }                ],                "business_service":[                    "BIZ_SERVICE_FREE_WIFI",                    "BIZ_SERVICE_WITH_PET",                    "BIZ_SERVICE_FREE_PARK",                    "BIZ_SERVICE_DELIVER"                ]            },            "deal_detail":"以下锅底2选1(有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸菜鱼            锅可选): 大锅1份 12元 小锅2份 16元 "        }    }}  

上述数据可以分为两个部分,即base_info(卡券基础信息)和Advanced_info(卡券高级信息)。

其中,基础信息的参数说明如表16-4所示。

表16-4 基础信息的参数说明

高级信息的参数说明如表16-5所示。

表16-5 高级信息的参数说明

正确创建时,返回的数据示例如下。


{    "errcode":0,    "errmsg":"ok",    "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"}  

上述数据的参数说明如表16-6所示。

表16-6 创建卡券接口返回参数说明

图16-1至图16-5分别展示了团购券、代金券、折扣券、兑换券(礼品券)、优惠券等的效果图。

图16-1 团购券

图16-2 代金券

图16-3 折扣券

图16-4 兑换券

图16-5 优惠券