录入红包信息


上一篇 : 创建红包活动 下一篇: 设置红包活动抽奖开关



接口说明

在调用"创建红包活动"接口之后,调用此接口录入红包信息。注意,此接口每次调用,都会向某个活动新增一批红包信息,如果红包数少于100个,请通过一次调用添加所有红包信息。如果红包数大于100,可以多次调用接口添加。请注意确保多次录入的红包ticket总的数目不大于创建该红包活动时设置的total值。

接口调用说明

服务器端调用
http请求方式: POST
URL:https://api.weixin.qq.com/shakearound/lottery/setprizebucket?access_token=ACCESSTOKEN

请求参数说明

参数 类型 说明
access_token string accesstoken,以参数的形式拼装在url后

POST BODY:JSON格式的结构体

参数 类型 说明
lottery_id string 红包抽奖id,来自addlotteryinfo返回的lottery_id
mchid string 红包提供者的商户号,,需与预下单中的商户号mch_id一致
sponsor_appid string 红包提供商户公众号的appid,需与预下单中的公众账号appid(wxappid)一致
prize_info_list json数组 红包ticket列表,如果红包数较多,可以一次传入多个红包,批量调用该接口设置红包信息。每次请求传入的红包个数上限为100
ticket string 预下单时返回的红包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=="
   }
 ]
}

返回数据说明

参数 类型 说明
errcode int 错误码。0为成功,其他为失败。详细请参考错误码表
errmsg string 错误信息
repeat_ticket_list array 重复使用的ticket列表,如为空,将不返回
expire_ticket_list array 过期的ticket列表,如为空,将不返回
invalid_amount_ticket_list array 金额不在大于1元,小于1000元的ticket列表,如为空,将不返回
success_num int 成功录入的红包数量
wrong_authmchid_ticket_list array 原因:生成红包的时候,授权商户号auth_mchid和auth_appid没有写摇周边的商户号
invalid_ticket_list array ticket解析失败,可能有错别字符或不完整

示例

{        
"errcode":0,    
"errmsg":"",    
"repeat_ticket_list":[        
   {            
"ticket": "v1|ZiPs2l0hpMBp3uwGI1rwp45vOdz/V/zQ/00jP9MeWT+e47/q1FJjwCIP34frSjzOxAEzJ7k2CtAg1pmcShvkChBWqbThxPm6MBuzceoHtj79iHuHaEn0WAO+j4sXnXnbGswFOlDYWg1ngvrRYnCY3g=="                      
   },
   {
"ticket":"v1|ZiPs2l0zzXCsdfwe45dxCdHiukOdz/V/zQ/89xcnC5XnT+e47/q1FJjwCO4frSjzOxAEzJ7k2CtAg1pmcShvkChBWzc45dDGC32Dcxx4DGxczjDCGsdjowe9iHuaEn0WAO+GswFOlDYWg1ngvrRYnCY3g=="         }        
   }
],
"success_num":100
}


上一篇 : 创建红包活动 下一篇: 设置红包活动抽奖开关