帮助中心  /  活动互动数据接口(旧版)

活动互动数据接口(旧版)

该接口用于获取H5活动互动数据,如活动中用户中奖数据、商品购买数据,根据不同活动,返回结果数据会有不同,具体以实际活动返回结果为准。

接口参数说明


接口请求

请求地址

https://api.rrx.cn/v2/data/getList

请求方式

GET

参数名称

是否必须

说明

app_key

人人秀平台分配的AppKey

time_stamp

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

sign

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

activity_guid

互动ID 如何获取互动ID

page

第几页数据

limit

每页多少条数据,默认20条,最多100条

start_time

开始时间,格式例如2099-09-10 09:10:00

end_time

结束时间,格式例如2099-09-10 09:10:00


接口响应

返回结果格式:JSON

结果参数

参数名称

是否必须

说明

result

0表示成功,1表示失败

msg

失败时返回,表示失败详细描述

data

成功时返回数据


data参数说明

参数名称

是否必须

说明

total

数据总笔数

rows

数据列表

activity_category

互动类型,例如表单,秒杀

columns

当前activity_category为表单时,才有返回值。

数据字段名称,依据制作表单里的元素显示。其中,最后3个字段是固定的。

分别是创建时间,渠道名称和渠道网址。

只有使用了渠道网址功能,才有渠道名称和渠道网址信息。


rows参数说明

1、当activity_category为表单时,rows表示:

每一列含义与columns列相对应。例如columns第一列表示姓名,则rows的第一列表示姓名。

返回示例:

{

   "result":0,

   "msg":"",

   "activity_category":"表单",

   "data":{

       "total":1,

       "rows":[

           [

               "张飞",

               "13145687845",

               "2099-12-12 01:10:31",

               "人人秀H5",

               "https://m.rrxiu.net/?v=knqw2x&qrc=1"

           ]

       ],

       "columons":[

           "姓名",

           "手机",

           "创建时间",

           "渠道名称",

           "渠道网址"

       ]

   }

}



2、当activity_category为非表单类型时,rows参数说明如下:

2.1、公共响应参数

参数名称

是否必须

说明

activity_info

活动信息

openid

微信openid

nickname

微信昵称

headimgurl

微信头像

create_time

时间

product_id

商品id

product_name

商品名称

product_state

商品状态,例如:已支付,未支付,已领取等

user_info

用户填写表单信息,只有用户填写了,才有值。

例如:[{name:'姓名',value:'张飞'}]

name表示表单字段;value表示表单字段值


activity_info参数说明

参数名称

是否必须

说明

title

活动标题

activity_name

互动名称

user_name

创建人

is_deleted

活动是否删除 ,1表示删除,0表示未删除


2.2、特殊响应参数

参数名称

是否必须

说明

pay_amount

支付金额,

当互动类型为:秒杀、拼团、砍价、拼团抽奖、商品列表、

送礼、助力、分销、优惠券、活动报名,返回该参数。

例如:{amont:10,gold:100}

amount表示现金;gold表示积分

order_no

订单号,

当互动类型为:秒杀、拼团、砍价、拼团抽奖、商品列表、

送礼、助力、分销、优惠券、活动报名,返回该参数。

coupon

优惠券,

当互动类型为:秒杀、商品列表、活动报名,返回该参数。

例如:{id:1234,memo:'满100减10',amount:10}

id表示优惠券id;memo表示备注;amount表示优惠金额



3、特殊互动响应参数

3.1、拼团特有响应参数

参数名称

是否必须

说明

progress

拼团进度

price

拼团价格

is_leader

是否团长,1表示团长,0表示不是团长

leader_discount_amount

团长优惠金额

remain_pay_amount

剩余支付金额


3.2、砍价特有响应参数

参数名称

是否必须

说明

progress

砍价进度

price

砍价价格

remain_pay_amount

剩余支付金额


3.3、助力特有响应参数

参数名称

是否必须

说明

progress

助力进度

price

助力价格

discount

助力折扣,数值范围0-10之间

prepay_amount

预付款金额

prepay_state

预付款状态

remain_pay_amount

剩余支付金额





常见问题

返回活动数据API

返回API文档首页