內容設計
該接口用于獲取活動排行榜的數(shù)據(jù)接口
請求地址 | https://open.www.bydok.cn/api/v1/activity/GetActivityTop | |
請求方式 | GET | |
參數(shù)名稱 | 是否必須 | 說明 |
app_key | 是 | 人人秀平臺分配的AppKey |
time_stamp | 是 | 1970-01-01開始的時間戳，精確到毫秒 |
sign | 是 | 根據(jù)簽名算法所得，如何計算簽名 |
activity_guid | 是 | 活動guid，如何獲取互動ID |
h5_guid | 否 | H5活動guid |
page | 是 | 分頁頁碼 |
limit | 否 | 每頁返回數(shù)量，不填默認20條，最大支持100條/頁 |
返回JSON格式結果 Content-type: application/json | ||
{"result":0,"msg":"","data":{}} | ||
參數(shù)名稱 | 說明 | |
result | 0表示成功，1表示失敗 | |
msg | 失敗是，返回的錯誤描述 | |
data | 詳情見data參數(shù)說明 | |
參數(shù)名稱 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
rows | 是 | object | 參與人列表，詳情見rows參數(shù)說明 |
activity_info | 是 | object | 活動信息，詳情見activity_info參數(shù)說明 |
total | 是 | int(32) | 參與人總數(shù) |
通用參數(shù)
參數(shù)名稱 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
rank | 是 | int(11) | 參與人排名 |
openid | 是 | string(128) | 參與人唯一標識 |
nickname | 是 | string(60) | 參與人顯示昵稱 |
headimgurl | 是 | string(200) | 參與人顯示頭像地址 |
create_time | 是 | datetime | 參與時間 |
source_name | 否 | string(60) | 推廣來源，活動從推廣渠道鏈接訪問時有值 |
employee_code | 否 | string(60) | 員工工號，在設置/應用客戶自定義字段啟用時有值 |
user_info | 否 | object | 報名信息，活動開啟完善信息參與后有值 |
verify_info | 否 | object | 驗證信息，獲取開啟驗證信息參與后有值 |
user_info 參數(shù)說明
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
id | 是 | int(11) | 數(shù)據(jù)ID |
title | 是 | string(100) | 數(shù)據(jù)標題 |
value | 是 | string(200) | 數(shù)據(jù)內容 |
verify_ info參數(shù)說明
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
title | 是 | string(100) | 數(shù)據(jù)標題 |
value | 是 | string(200) | 數(shù)據(jù)內容 |
支持答題、每日一答、闖關答題、學習答題
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
answer_count | 是 | int(11) | 答題次數(shù) |
score | 是 | int(11) | 得分 |
right_rate | 是 | string(10) | 正確率(%) |
group_name | 否 | string(60) | 分組名稱，開啟時有值 |
last_update_time | 是 | datetime | 最后更新時間 |
支持視頻答題、猜燈謎、考試
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
answer_count | 是 | int(11) | 答題次數(shù) |
score | 是 | int(11) | 得分 |
right_rate | 是 | string(10) | 正確率(%) |
last_update_time | 是 | datetime | 最后更新時間 |
支持PK答題
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
pk_level | 是 | int(11) | 答題等級 |
answer_count | 是 | int(11) | 答題次數(shù) |
score | 是 | int(11) | 得分 |
right_rate | 是 | string(10) | 正確率(%) |
last_update_time | 是 | datetime | 最后更新時間 |
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
serial_number | 是 | int(11) | 編號 |
vote_count | 是 | int(11) | 票數(shù) |
vote_photo | 是 | string(200) | 投票圖片 |
group_name | 是 | string(60) | 分組名稱 |
user_info | 是 | object | 報名信息，參考公共參數(shù) |
comment_count | 否 | int(11) | 評論數(shù)量 |
voice_url | 否 | string(200) | 語音投票地址 |
video_url | 否 | string(200) | 視頻投票地址 |
支持有獎競猜
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
gold | 是 | int(11) | 金幣數(shù) |
支持每日打卡
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
sum_count | 是 | int(11) | 累計打卡次數(shù) |
continue_count | 是 | int(11) | 連續(xù)打開次數(shù) |
支持留言抽獎
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
likes_count | 是 | int(11) | 點贊數(shù) |
支持游戲、闖關游戲
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
best_score | 是 | int(11) | 最高分 |
best_time | 是 | datetime | 最長用時 |
helper_count | 否 | int(11) | 助力人數(shù) |
helper_score | 否 | int(11) | 助力分數(shù) |
last_update_time | 是 | datetime | 最后更新時間 |
支持養(yǎng)成游戲
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
best_score | 是 | int(11) | 最高分 |
last_update_time | 是 | datetime | 最后更新時間 |
支持漂流瓶、許愿樹、孔明燈、賀卡
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
invite_count | 是 | int(11) | 邀請人數(shù) |
last_update_time | 是 | datetime | 最后更新時間 |
支持任務寶、限時有禮、裂變海報
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
invite_count | 是 | int(11) | 邀請人數(shù) |
last_update_time | 是 | datetime | 最后更新時間 |
支持集字助力
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
collect_total | 是 | int(11) | 集字總數(shù) |
collect_count | 是 | int(11) | 集字套數(shù) |
last_update_time | 是 | datetime | 最后更新時間 |
支持分銷
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
invite_total | 是 | int(11) | 邀請人數(shù) |
total_amount | 是 | float(2) | 分銷總金額 |
total_commission | 是 | float(2) | 總傭金(元) |
commission_amount | 是 | float(2) | 一級傭金（元） |
second_commission_amount | 否 | float(2) | 二級傭金（元） |
1.適用于投票類活動，
2.適用于答題類活動，支持答題、每日一答、趣味答題、猜燈謎、視頻答題、PK答題、考試；
3.適用于活動類互動，支持有獎競猜、每日打卡、留言抽獎；
4.使用于游戲類活動，支持游戲、闖關游戲、養(yǎng)成游戲；
5.適用于裂變類活動，支持集字助力、任務寶、限時有禮、裂變海報；
6.適用于電商類活動，分銷
7.適用于節(jié)日類活動，支持許愿樹、孔明燈、心愿池
活動排行榜數(shù)據(jù)最多返回1萬條數(shù)據(jù)。
請求示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"activity_guid": "f2f219309b5c1a021fc019b3b557b9f8",
"h5_guid":"123456",
"page ":1,
"limit ":20
}
返回值示例， json格式 Content-type: application/json
{
"result": 0,
"data": {
"total": 10,
"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",
"source_name": "百度",
"employee_code": "",
"user_info": [
{ "id": "100","title": "姓名","value": "張三"},
{"id": "300","title": "手機號","value": "15811111111"},
]，
"verify_info": [
{"title": "手機號","value": "15811111111"},
]
}]
},
"msg": "ok"
}
