帮助中心  /  活动中奖记录接口

活动中奖记录接口

该接口用于获取活动中奖用户奖品记录


接口参数说明

请求地址

https://open.rrx.cn/api/v1/activity/GetActivityOrder

请求方式

GET

参数名称

是否必须

说明

app_key

是

人人秀平台分配的AppKey

time_stamp

是

1970-01-01开始的时间戳,精确到毫秒

sign

是

根据签名算法所得,如何计算签名

activity_guid

是

活动guid ,如何获取互动ID

h5_guid

否

H5活动guid

page

是

分页页码

limit

否

每页返回数量,不填默认20条,最大支持100条/页

start_time

否

查询起始时间

end_time

否

查询结束时间


返回JSON格式结果 Content-type: application/json

{"result":0,"msg":"","data":{}}

参数名称

说明

result

0表示成功,1表示失败

msg

失败时,返回的错误描述

data

详情见data参数说明

 

data参数说明

参数名称

是否必须

说明

rows

是

中奖记录列表,详情见rows参数说明

activity_info

是

活动信息,详情见activity_info参数说明

total

是

中奖总数

 

rows参数说明

参数名称

是否必须

说明

openid

是

用户当前授权标识

nickname

是

用户授权昵称

headimgurl

是

用户授权头像

create_time

是

中奖时间

product_id

是

奖品ID

product_name

是

奖品名称

product_type

是

奖品类型枚举:1:实物;2:红包;5:优惠券;6:积分;7:自有奖品;8:礼品;12:微信卡劵;

product_detail

否

仅当奖品类型为红包、积分、优惠劵,有明细值,例如积分值"5"

product_state

是

领取状态:已领取,未领取

order_no

是

中奖记录对应人人秀订单号。奖品领取后产生订单记录,可通过订单记录接口获取订单详情

source_name

否

推广来源,活动从推广渠道访问时有值

 

activity_info 参数说明

参数名称

是否必须

说明

activity_name

是

活动名称

is_deleted

是

是否删除 0:未删除 1:已删除

user_name

是

创建用户名称

 


活动支持说明

  • 1.适用于抽奖类活动玩法,抽奖、定时抽奖、签到抽奖、留言抽奖、口令抽奖、日历抽奖、扫码领奖、VR抽奖等奖品类活动;

  • 2.适用于活动支持开启抽奖功能类活动,比如答题、投票、新年签、游戏、养成游戏、问卷表单等。


请求示例

{

    "app_key": "96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"activity_guid": "f2f219309b5c1a021fc019b3b557b9f8",

"h5_guid":"123456",

"page ":1,

"limit ":20,

"start_time":"2099-09-10 09:10:00",

"end_time":"2099-09-10 09:10:00",

 

}

 

 

 

返回值示例, json格式 Content-type: application/json

{

    "result": 0,

    "data": {

         "total": 1,

"activity_info": {

"activity_name": "抽奖",

"user_name": "张三",

"is_deleted": 0,

},

"rows": [{

"openid ": " gb_1543999047492",

"nickname": "小张子",

"headimgurl": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TMaE…zXTfZQugNBA/132",

     "create_time": "2099-09-10 09:10:00",

"product_id": "10001",

"product_name": "商品1",

"product_type": "1",

"product_state": "已领取",

"order_no": "TP1543999047492",

"source_name": "百度",

}]

    },

    "msg": "ok"

}




相关文档