红包查询接口

接口说明

查询红包活动信息。

接口调用说明

服务器端调用
http请求方式: Get
URL:https://api.weixin.qq.com/shakearound/lottery/querylottery?access_token=ACCESSTOKEN&lottery_id=LOTTERYID

请求参数说明

参数类型说明
access_tokenstringaccesstoken,以参数的形式拼装在url后
lottery_idstring红包抽奖id,来自addlotteryinfo返回的lottery_id

返回数据说明

参数类型说明
errcodeint错误码。0为成功,其他为失败。详细请参考错误码表
errmsgstring错误信息
titlestring抽奖活动名称(选择使用模板时,也作为摇一摇消息主标题),最长6个汉字,12个英文字母。
descstring抽奖活动描述(选择使用模板时,也作为摇一摇消息副标题),最长7个汉字,14个英文字母。
onoffint抽奖开关。0关闭,1开启,默认为1
begin_timelong抽奖活动开始时间,unix时间戳,单位秒
expire_timelong抽奖活动结束时间,unix时间戳,单位秒,红包活动有效期最长为91天
sponsor_appidstring红包提供商户公众号的appid
appidstring创建活动的开发者appid
prize_countlong已录入的红包总数
prize_count_limitlong创建活动时预设的录入红包ticket数量上限
jump_urlstring红包关注界面后可以跳转到第三方自定义的页面
expired_prizeslong过期红包ticket数量
drawed_prizeslong已发放的红包ticket数量
available_prizeslong可用的红包ticket数量
expired_valuelong已过期的红包金额总和
drawed_valuelong已发放的红包金额总和
available_valuelong可用的红包金额总和   

注意:调用SetPrizeBucket录入红包次数超过3000次的,或红包总数超过1万个的活动,目前暂不支持expired_prizes, drawed_prizes, available_prizes, expired_value, drawed_value, available_value这6个字段的查询。需要查询时,可以通过邮箱zhoubian@tencent.com联系我们,也可加入开发者QQ交流群390582489。

示例

{    
"errcode":0,    
"errmsg":""
result:{
   lottery_id:” 9sQqUrmdFaY6v9z8TartOA”,
   title:”活动标题”,
   desc:”活动描述”,
   onoff:”1”,
   begin_time:” 1446360417”,
   expire_time:” 1446400000”,
   sponsor_appid:” wxf5b5e87a6a0fde94”,
   appid:”wx4428b5f51c53a582”,
   prize_count_limit:1000,
   prize_count: 810,
   jump_url:”http://www.qq.com/”,
   expired_prizes: 100,
   drawed_prizes:200,
   available_prizes:510,
   expired_value: 10000,
   drawed_value:20000,
   available_value: 51000
   }  
}