微信摇一摇红包介绍说明

用p12文件，而需要使用pem，为了方便您使用，已为您直接提供您也可以使用openssl命令来自己导出：openssl pkcs12 -nocerts -in apiclient_cert.p12 -out apiclient_key.pemCA证书（rootca.pem）微信支付api服务器上也部署了证明微信支付身份的服务器证书，您在使用api进行调用时也需要验证所调用服务器及域名的真实性该文件为签署微信支付证书的权威机构的根证书，可以用来验证微信支付服务器证书的真实性部分工具已经内置了若干权威机构的根证书，无需引用该证书也可以正常进行验证，这里提供给您在未内置所必须根证书的环境中载入使用2. 使用商户证书apiclient_cert.p12是商户证书文件，除PHP外的开发均使用此证书文件。商户如果使用.NET环境开发，请确认Framework版本大于2.0，必须在操作系统上双击安装证书apiclient_cert.p12后才能被正常调用。商户证书调用或安装都需要使用到密码，该密码的值为微信商户号（mchid）PHP开发环境请使用商户证书文件apiclient_cert.pem和apiclient_key.pem ，rootca.pem是CA证书。3. 商户证书安全证书文件放在非web服务器虚拟目录的文件夹下，防止被他人下载。商户服务器要做好病毒和木马防护工作，不被非法侵入者窃取证书文件。 创建红包活动接口说明创建红包活动，设置红包活动有效期，红包活动开关等基本信息，返回活动id接口调用说明服务器端调用http请求方式: POSTURL: https://api.weixin.qq.com/shakearound/lottery/addlotteryinfo?access_token=ACCESSTOKEN&use_template=1&logo_url=LOGO_URL请求参数说明参数类型说明access_tokenstringaccesstoken,以参数的形式拼装在url后use_templateint是否使用模板，1：使用，2：不使用,以参数的形式拼装在url后。（模版即交互流程图中的红包加载页，使用模板用户不需要点击可自动打开红包；不使用模版需自行开发HTML5页面，并在页面调用红包jsapi）logo_urlstring使用模板页面的logo_url，不使用模板时可不加。展示在摇一摇界面的消息图标。图片尺寸为120x120。POST BODY：JSON格式的结构体参数类型说明titlestring抽奖活动名称（选择使用模板时，也作为摇一摇消息主标题），最长6个汉字，12个英文字母。descstring抽奖活动描述（选择使用模板时，也作为摇一摇消息副标题），最长7个汉字，14个英文字母。onoffint抽奖开关。0关闭，1开启，默认为1begin_timelong抽奖活动开始时间，unix时间戳，单位秒expire_timelong抽奖活动结束时间，unix时间戳，单位秒,红包活动有效期最长为91天sponsor_appidstring红包提供商户公众号的appid，需与预下单中的公众账号appid（wxappid）一致totallong红包总数，红包总数是录入红包ticket总数的上限，因此红包总数应该大于等于预下单时红包ticket总数。jump_urlstring红包关注界面后可以跳转到第三方自定义的页面keystring开发者自定义的key，用来生成活动抽奖接口的签名参数，长度32位。使用方式见sign生成规则请求示例Content-Type: application/json Post Body:{ "title": "title", "desc": "desc", "onoff": 1, "begin_time": 1428854400, "expire_time": 1428940800, "sponsor_appid": "wxxxxxxxxxxxxxx", "total": 10, "jump_url": JUMP_URL, "key": "keyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" } 返回数据说明参数类型说明errcodeint错误码。0为成功，其他为失败。详细请参考错误码表errmsgstring错误信息lottery_idstring生成的红包活动idpage_idint生成的模板页面ID示例{ "errcode":0, "errmsg":"", "lottery_id":"xxxxxxllllll", "page_id":1, } 录入红包信息接口说明在调用"创建红包活动"接口之后，调用此接口录入红包信息。注意，此接口每次调用，都会向某个活动新增一批红包信息，如果红包数少于100个，请通过一次调用添加所有红包信息。如果红包数大于100，可以多次调用接口添加。请注意确保多次录入的红包ticket总的数目不大于创建该红包活动时设置的total值。接口调用说明服务器端调用http请求方式: POSTURL:https://api.weixin.qq.com/shakearound/lottery/setprizebucket?access_token=ACCESSTOKEN请求参数说明参数类型说明access_tokenstringaccesstoken,以参数的形式拼装在url后POST BODY：JSON格式的结构体参数类型说明lottery_idstring红包抽奖id，来自addlotteryinfo返回的lottery_idmchidstring红包提供者的商户号，，需与预下单中的商户号mch_id一致sponsor_appidstring红包提供商户公众号的appid，需与预下单中的公众账号appid（wxappid）一致prize_info_listjson数组红包ticket列表，如果红包数较多，可以一次传入多个红包，批量调用该接口设置红包信息。每次请求传入的红包个数上限为100ticketstring预下单时返回的红包ticket，单个活动红包ticket数量上限为100000个，可添加多次。请求示例Content-Type: application/json Post Body:{ "lottery_id": "xxxxxxllllll", "mchid": "10000098", "sponsor_appid": "wx8888888888888888", "prize_info_list": [ { "ticket": "v1|ZiPs2l0hpMBp3uwGI1rwp45vOdz/V/zQ/00jP9MeWT+e47/q1FJjwCIP34frSjzOxAEzJ7k2CtAg1pmcShvkChBWqbThxPm6MBuzceoHtj79iHuHaEn0WAO+j4sXnXnbGswFOlDYWg1ngvrRYnCY3g==" }, { "ticket": "v1|fOhNUTap1oepSm5ap0hx1gmATM\/QX\/xn3sZWL7K+5Z10sbV5\/mZ4SwxwxbK2SPV32eLRvjd4ww1G3H5a+ypqRrySi+4oo97y63KoEQbRCPjbkyQBY8AYVyvD40V2b9slTQCm2igGY98mPe+VxZiayQ==" } ]}返回数据说明参数类型说明errcodeint错误码。0为成功，其他为失败。详细请参考错误码表errmsgstring错误信息repeat_ticket_listarray重复使用的ticket列表，如为空，将不返回expire_ticket_listarray过期的ticket列表，如为空，将不返回invalid_amount_ticket_listarray金额不在大于1元，小于1000元的ticket列表，如为空，将不返回success_numint成功录入的红包数量wron