接口说明
查询红包活动信息。
接口调用说明
服务器端调用
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
}
}