帮助中心  /  活动列表接口

活动列表接口

该接口用于获取用户创建的活动。


接口参数说明

接口请求

请求地址                 

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

请求方式                 

GET                 

参数名称                 

是否必须                

说明                 

app_key                 

               

人人秀平台分配的AppKey                 

time_stamp                 

               

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

sign                 

               

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

page                 

               

第几页数据                 

limit                 

               

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

start_time                 

               

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

end_time                 

               

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

query_time_way                 

               

依据时间查询方式,默认按创建时间查询                 

1表示按创建时间查询                

2表示按更新时间查询                

login_id            

                

登录账号,查询指定账号创建的活动。   查看子账号账号 

空则是主账号,则查询主账号及其子账号创建的活动。                 



接口响应

返回结果格式:JSON

结果参数

参数名称                

是否必须                

说明                

result                

               

0表示成功,1表示失败                

msg                

               

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

data                

               

{total:1,rows:[]}                


data参数说明

参数名称                

是否必须                

说明                

total                

               

数据总笔数                

rows                

               

数据列表                


rows参数说明

参数名称                

是否必须                 

说明                 

h5_guid                 

               

活动ID                 

title                 

               

活动标题                 

describe                 

               

分享描述                 

share_image_url                 

               

分享头像                 

visit_url                 

               

活动访问地址                 

pv                 

               

访问数                 

uv                 

               

访客数                 

share_count                 

               

分享数                 

create_time                 

               

创建时间                 

last_update_time                 

               

更新时间                 

user_name                 

               

创建者                 

login_id                 

               

创建者的登录账号                 

is_deleted                 

               

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

state                 

               

活动作品状态,1:启用,2:停用

type                 

               

活动类型, type枚举,1:H5;2:互动;3:活动专题;4:文章;5:海报

activity_list                 

               

互动列表                 



active_list参数说明

参数名称                

是否必须                 

说明                 

activity_guid                 

               

互动ID                 

activity_name                 

               

互动名称                 

activity_category                 

               

互动类型,例如砍价,秒杀                 

state                 

               

状态,例如未开始,进行中                 

start_time                 

               

互动开始时间                 

end_time                 

               

互动结束时间                 

join_count                 

               

参与人次                 

share_count                 

               

分享次数             


请求示例

{

    "app_key""96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"page ":1,

"limit ":20,

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

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

"query_time_way":1,

"login_id":""

}

 

 

 

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

{

    "result"0,

    "data": {

         "total"10,

"rows"[{

"h5_guid""q2d0qt",

"title""未命名活动",

"describe""分享微信好友",

     "share_image_url""https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4Tw...XTfZQugNBA/132", 

    "visit_url""https://ca.rrx.cn/v/q2d0qt?v=1",

    "pv"1000,

    "uv"100,

    "share_count"100,

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

    "last_update_time""2099-09-10 09:20:00",

    "user_name""张三",

    "login_id""158111111111",

    "is_deleted"0,

    "state": 1,

    "type"1,

    "activity_list"[

            {

                 "activity_guid""f2f219309b5c1a021fc019b3b557b9f8",

"activity_name""抽奖活动",

"activity_category""抽奖",

"state""未开始",

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

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

"join_count"0,

"share_count"0,

}]

 }

]

    },

    "msg""ok"

}

 



相关文档