红包查询接口


上一篇 : 红包绑定用户事件通知 下一篇: 摇一摇周边错误码



接口说明

查询红包活动信息。

接口调用说明

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

请求参数说明

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

返回数据说明

参数 类型 说明
errcode int 错误码。0为成功,其他为失败。详细请参考错误码表
errmsg string 错误信息
title string 抽奖活动名称(选择使用模板时,也作为摇一摇消息主标题),最长6个汉字,12个英文字母。
desc string 抽奖活动描述(选择使用模板时,也作为摇一摇消息副标题),最长7个汉字,14个英文字母。
onoff int 抽奖开关。0关闭,1开启,默认为1
begin_time long 抽奖活动开始时间,unix时间戳,单位秒
expire_time long 抽奖活动结束时间,unix时间戳,单位秒,红包活动有效期最长为91天
sponsor_appid string 红包提供商户公众号的appid
appid string 创建活动的开发者appid
prize_count long 已录入的红包总数
prize_count_limit long 创建活动时预设的录入红包ticket数量上限
jump_url string 红包关注界面后可以跳转到第三方自定义的页面
expired_prizes long 过期红包ticket数量
drawed_prizes long 已发放的红包ticket数量
available_prizes long 可用的红包ticket数量
expired_value long 已过期的红包金额总和
drawed_value long 已发放的红包金额总和
available_value long 可用的红包金额总和

注意:调用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
   }  
}


上一篇 : 红包绑定用户事件通知 下一篇: 摇一摇周边错误码