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