多啦客传媒平台对接微信摇一摇说明文档副本

南京多啦客网络传媒有限公司近场营销解决方案多啦客传媒平台对接微信摇一摇说明文档南京鲜老虎微信摇一摇卡券分为现金卡券、折扣卡券、通用券（礼品、创意等券）三大类；橘花分期平台需要对接到就是一个卡券功能，当微信摇一摇当卡券通过核销时可以直接在橘花分期平台上进行使用。摇一摇关注JSAPI摇一摇关注JSAPI目的是为已开通微信摇一摇周边，且有一定开发能力的商户提供摇一摇关注能力。商户可以在摇出来的页面直接调用摇一摇关注接口，实现关注公众账号的功能。数据示例关注JSAPI调用与微信的JSAPI调用格式一致，如下：公用函数invoke用途主动调用指定API通用形式BeaconAddContactJsBridge.invoke(API名称,{调用参数},回调函数);注意：文档中所有代码只能在微信摇周边的场景下才能正确运行。直接在微信浏览器中打开网页，BeaconAddContactJsBridge不会正确运行。开发人员调试的时候注意，必须走完整的摇周边流程，通过摇一摇进入页面测试。例子：!DOCTYPEhtmlhtmllang=enheadmetacharset=UTF-8title开发者调用关注JS的example/title/headbodyscripttype=text/javascriptsrc==text/javascriptBeaconAddContactJsBridge.ready(function(){//判断是否关注BeaconAddContactJsBridge.invoke('checkAddContactStatus',{},function(apiResult){if(apiResult.err_code==0){varstatus=apiResult.data;if(status==1){alert('已关注');}else{alert('未关注');//跳转到关注页BeaconAddContactJsBridge.invoke('jumpAddContact');}}else{alert(apiResult.err_msg)}});});/script/body/html引入BeaconAddContactJsBridge南京多啦客网络传媒有限公司近场营销解决方案scripttype=text/javascriptsrc=详细说明(一)判断是否关注checkAddContactStatusa)参数：无，传入{}b)回调函数：function(apiResult){}apiResult.err_code:错误码，0代表正常返会，其他代表发生错误。apiResult.err_msg:错误详情，“ok”代表正常返回，其他代表具体的错误信息。apiResult.data:是否关注，1代表已经关注，0代表未关注例子：BeaconAddContactJsBridge.invoke('checkAddContactStatus',{},function(apiResult){if(apiResult.err_code==0){varstatus=apiResult.data;if(status==1){alert('已关注');}else{alert('未关注');}}else{alert(apiResult.err_msg)}});(二)跳转到关注页jumpAddContacta)参数：无。JSAPI通过查询后台获取设备所归属的公众账号，而不是直接在JSAPI参数中获取，因此只能关注此设备归属的公众账号。b)回调函数：无例子：BeaconAddContactJsBridge.invoke('jumpAddContact');卡券接口概述微信公众平台本次增加了微信卡券功能，开放接口供商家使用。支持开发者调用接口创建多种类型的卡券，通过下发消息、二维码、JS-SDK等方式进行投放，在用户使用时通过API接口或卡券商户助手完成核销。同时支持接口获取统计数据，以及各个环节给予开发者事件推送。接口调用流程图如下：南京多啦客网络传媒有限公司近场营销解决方案卡券HelloWorld开发者须知开发者可以通过debug工具，快速完成创建卡券、投放卡券和核销卡券的流程，若要深入了解卡券接口，则需要对对应的部分的文档详细阅读。获取access_tokendebug页面获取页面地址：接口类型：基础支持接口列表：获取access_token接口注意事项：参数填写开发者的appid和secret点击检查问题，即可返回access_token，access_token的有效期是两小时，两小时之后须重新获取南京多啦客网络传媒有限公司近场营销解决方案接口地址：获取Accesstoken接口上传卡卷logodebug页面获取页面地址：接口类型：基础支持接口列表：上传logo接口access_token:上一步获得的access_tokenbuffer：你选择的图片点击检查问题，即可获取图片url，在下一步创建卡劵的参数中需要接口地址：上传Logo接口创建卡卷debug页面创建页面地址：接口类型：卡劵接口南京多啦客网络传媒有限公司近场营销解决方案接口列表：创建卡劵接口access_token:第一步获得的access_tokenjson:示例：{card:{card_type:GROUPON,groupon:{base_info:{logo_url::海底捞,code_type:CODE_TYPE_TEXT,title:132元双人火锅套餐,sub_title:周末狂欢必备,color:Color010,notice:使用时向服务员出示此券,service_phone:[phone],description:不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食,date_info:{type:DATE_TYPE_FIX_TERM,fixed_term:15,fixed_begin_term:0},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],custom_url_name:立即使用,custom_url::6个汉字tips,promotion_url_name:更多优惠,promotion_url::大众点评},deal_detail:以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸菜鱼锅可选）：\n大锅1份12元\n小锅2份16元}}}注意事项：date_info中用的是Unix时间戳，注意把begin_timestamp修改小于当前时间，end_timestamp修改成今天之后的时间，这样在后面核销卡劵测试才能成功接口地址：创建卡券接口创建二维码投放debug页面获取页面地址：接口类型：卡劵接口接口列表：创建二维码ticket接口access_token：第一步获得的access_tokenjson示例：南京多啦客网络传媒有限公司近场营销解决方案{action_name:QR_CARD,action_info:{card:{card_id:po_2DjgJ2zrboM6SzK3qNuje5iWQ,}}}接口地址：创建二维码接口显示二维码在上一步的返回中点击字段show_qrcode_url字段中的链接，即可显示卡券领取二维码。示例：=gQEr8ToAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xLy1YV21CQi1sc3dUS0p1M3NjRjVuAAIE3kqwVQMEgDPhAQ==打开微信扫一扫，然后领取卡劵，如果显示卡劵未通过审核，那么需要下一步设置测试白名单，如果可以领取就忽略第六步。设置测试白名单debug页面获取页面地址：接口类型：卡劵接口接口列表：设置测试白名单接口access_token：第一步获得的access_tokenjson示例：{username:[usr1,usr2]}注意事项：其中usr1，sur2是领取卡劵的微信号接口地址：设置白名单接口核销卡劵debug页面获取页面地址：南京多啦客网络传媒有限公司近场营销解决方案接口类型：卡劵接口接口列表：核销卡劵接口access_token：第一步获得的access_tokenjson:示例：{code：759733467744}注意事项：仅支持审核通过且在有效期内的卡劵接口地址：核销接口开发者注意事项微信版本判断由于微信6.0.2版本后才支持卡券功能模块，低版本用户调用JS-SDK无效。因此，微信团队建议商户通过useragent来确定用户当前的版本号后再调用添加至卡包JS-SDK接口。以iPhone版本为例，可以通过useragent可获取如下版本示例信息：Mozilla/5.0(iphone;CPUiphoneOS5_1_1likeMacOSX)AppleWebKit/534.46(KHTML,likeGeocko)Mobile/9B206MicroMessenger/6.0.2其中6.0.2为用户安装的微信版本号。商户可以判定版本号是否高于或者等于6.0.2。卡券投放限制公众号会话环境内仅支持调起该公众号域名下的卡券。未经平台允许不支持在公众号会话内推送其他商户的卡券，公众号会话外（如朋友圈、对话环境）无此限制。特别注意事项公众号的对话框中发生的行为以及从公众号对话框跳转的网页链接均处于该公众号的会话环境内。编码规则所有API接口POST的数据只支持utf8编码，否则会返回报错。联系我们南京多啦客网络传媒有限公司近场营销解决方案遇到卡券开发问题，可以通过邮箱[e-mail]联系我们。也可以加入开发者QQ交流群198219212，验证请务必说明商家名及业务。卡券术语介绍以下是卡券开发过程中需要了解的关键概念：参数名描述cardid卡券ID。一个卡券ID对应一类卡券，包含了相应库存数量的Code码。code卡券Code码。一张卡券的唯一标识，核销卡券时使用此串码，支持商户自定义。openid用户在该公众号下的唯一身份。access_token调用接口的凭证，有效时间为7200s，通过获取access_token接口获取。api_ticket调用微信卡券接口时签名的临时票据，通