抽奖 - App.Site.Draw - PhalApi开源接口框架 - 在线接口文档

接口地址：https://b1.xqhd.cn/?s=App.Site.Draw

请求方式 GET/POST

接口描述：服务端完成资格/次数/概率/库存校验并返回抽奖结果；带wx_token（小程序）时每日/累计限次按微信号(openid)计数

接口参数

参数名字	类型	是否必须	默认值	其他	说明
activity_id	字符串	必须		最大：32	活动随机标识（H5网址中的slug）
participant_id	整型	必须		最小：1	参与用户ID
code	字符串	可选		最大：32	抽奖码，选填；活动开启凭码参与时必填
wx_token	字符串	可选		最大：200	小程序微信身份凭证（携带时限次按微信号计数）

返回结果

参数名字	类型	说明
is_win	整型	是否中奖：0否 1是
prize_id	整型	中奖奖品ID，未中奖为0
prize_name	字符串	中奖奖品名称
verify_code	字符串	核销码（中奖时返回）

错误列表

错误状态码	错误描述信息
400	表示客户端参数错误
404	表示接口服务不存在
500	表示服务端内部错误
421	活动已暂停
422	活动尚未开始
423	活动已结束
425	今日抽奖次数已用完
426	抽奖次数已用完
431	微信用户抽奖次数已用完（微信限抽次数配置）
429	当前网络今日抽奖次数已达上限
427	抽奖码无效或已使用
428	本活动需凭抽奖码参与

在线测试

参数	是否必须	值
service	必须
activity_id	必须
participant_id	必须
code	可选
wx_token	可选

客户端请求示例

# 暂无示例，可添加示例文件：./src/view/docs/demos/App.Site.Draw.json

温馨提示： 此接口文档根据接口代码和注释实时自动生成，帮助文档请见PhalApi 2.x 开发文档。