內(nèi)容設(shè)計
該接口用于獲取活動參與人的數(shù)據(jù)接口
當前接口為v2版本，v1版本點擊此處
請求地址 | https://open.m.bydok.cn/api/v2/activity/GetActivityJoin | |
請求方式 | 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格式結(jié)果 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ù)類型 | 說明 |
openid | 是 | string(128) | 參與人唯一標識 |
nickname | 是 | string(60) | 參與人顯示昵稱 |
headimgurl | 是 | string(200) | 參與人顯示頭像地址 |
create_time | 是 | datetime | 參與時間 |
source_name | 否 | string(60) | 推廣來源，活動從推廣渠道鏈接訪問時有值 |
employee_code | 否 | string(60) | 員工工號，在設(shè)置/應(yīng)用客戶自定義字段啟用時有值 |
user_info | 否 | object | 報名信息，活動開啟完善信息參與后有值 |
user_info 參數(shù)說明
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
id | 是 | int(11) | 數(shù)據(jù)ID |
title | 是 | string(100) | 數(shù)據(jù)標題 |
value | 是 | string(200) | 數(shù)據(jù)內(nèi)容 |
支持答題、每日一答、闖關(guān)答題、考試、視頻答題、猜燈謎
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 答題次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
total_score | 是 | int(11) | 答題分數(shù) |
error_count | 是 | int(11) | 答題錯題數(shù) |
right_rate | 是 | string(100) | 答題正確率（%） |
last_join_time | 是 | datetime | 最后答題參與時間 |
支持趣味答題
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 答題次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
total_score | 是 | int(11) | 答題分數(shù) |
last_join_time | 是 | datetime | 最后答題參與時間 |
支持學(xué)習(xí)答題
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
study_count | 是 | int(11) | 學(xué)習(xí)次數(shù) |
study_time | 是 | int(11) | 學(xué)習(xí)時長（秒） |
join_count | 是 | int(11) | 答題次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
total_score | 是 | int(11) | 答題分數(shù) |
error_count | 是 | int(11) | 答題錯題數(shù) |
right_rate | 是 | string(100) | 答題正確率，x% |
last_join_time | 是 | datetime | 最后答題時間 |
last_study_time | 是 | datetime | 最后學(xué)習(xí)時間 |
支持抽獎、紅包、留言抽獎、掃描領(lǐng)獎、定時抽獎、VR抽獎、日歷抽獎、口令抽獎、小票抽獎
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 抽獎次數(shù)（留言次數(shù)、簽到次數(shù)） |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持簽到抽獎
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 簽到次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
connect_count | 是 | int(11) | 連續(xù)簽到次數(shù) |
gold_amount | 是 | int(11) | j金幣數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持語音紅包、口令紅包
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 參與次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
支持游戲、闖關(guān)游戲、養(yǎng)成游戲
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
total_score | 是 | int(11) | 參與人游戲分數(shù)（其他排行指標，金幣數(shù)等） |
join_count | 是 | int(11) | 參與次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持問卷調(diào)查、報名表單、投票評選、360測評
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 抽獎次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持投票、圖片合成、圖片生成器
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 參與次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持每日打卡
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 累計簽到次數(shù) |
continue_count | 是 | int(11) | 連續(xù)簽到次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持活碼
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 累計簽到次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持活動報名
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
order_no | 是 | string | 訂單編號 |
pay_amount | 是 | float(2) | 價格 |
state_name | 是 | string(10) | 狀態(tài) |
order_type | 是 | string(10) | 票種 |
支持有獎競猜
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 參與次數(shù) |
guesss_gold | 是 | int(11) | 參與人金幣數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持年度賬單
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 參與次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持打賞
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 參與次數(shù) |
pay_amount | 是 | float(2) | 打賞金額（2位小數(shù)） |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持漂流瓶、許愿樹、孔明燈、新年Flag、新年簽、節(jié)日頭像、代言海報
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 抽獎次數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持賀卡
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
join_count | 是 | int(11) | 參與次數(shù) |
invite_count | 是 | int(11) | 邀請人數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
last_join_time | 是 | datetime | 最后參與時間 |
支持任務(wù)寶、限時有禮
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
invite_target_name | 是 | string(100) | 任務(wù)獎品名稱 |
invite_target | 是 | int(11) | 任務(wù)目標人數(shù) |
invite_count | 是 | int(11) | 邀請人數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
支持集字助力
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
collect_total | 是 | int(11) | 集字總數(shù) |
collect_count | 是 | int(11) | 集字套數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
支持拆禮盒
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
invite_target_name | 是 | string(100) | 任務(wù)獎品名稱 |
invite_target | 是 | int(11) | 任務(wù)目標人數(shù) |
invite_count | 是 | int(11) | 邀請人數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
支持一元解鎖
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
pay_amount | 是 | float(2) | 購買金額（2位小數(shù)） |
pay_count | 是 | int(11) | 購買次數(shù) |
invite_count | 是 | int(11) | 邀請人數(shù) |
支持裂變海報
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
invite_count | 是 | int(11) | 邀請人數(shù) |
win_prize_count | 是 | int(11) | 中獎次數(shù) |
receive_prize_count | 是 | int(11) | 領(lǐng)獎次數(shù) |
支持砍價
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
progress | 是 | string(60) | 砍價進度（%） |
remain_price | 是 | float(2) | 剩余砍價金額 |
pay_amount | 是 | float (2) | 已支付金額 |
remain_amount | 是 | float(2) | 剩余支付金額 |
state_name | 是 | string(10) | 訂單狀態(tài) |
receive_time | 否 | datetime | 兌換時間 |
支持助力
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
hlep_count | 是 | int(11) | 助力人數(shù) |
remain_price | 是 | float(2) | 助力金額 |
pay_amount | 是 | float (2) | 已支付金額 |
remain_amount | 是 | float(2) | 剩余支付金額 |
state_name | 是 | string(10) | 訂單狀態(tài) |
receive_time | 否 | datetime | 兌換時間 |
支付分銷
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
commission_amount | 是 | float (2) | 一級傭金 |
second_commission_amount | 是 | float (2) | 二級傭金 |
pay_amount | 是 | float (2) | 已支付金額 |
支持拼團
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
sart_group_time | 是 | datetime | 開團時間 |
pay_amount | 是 | float(2) | 已支付金額 |
group_price | 是 | float (2) | 成團價格 |
is_captain | 是 | int(1) | 是否團長 |
pay_type | 是 | string(10) | 付款方式 |
group_rule_type | 是 | string(10) | 成團類型 |
支持萬人團
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
sart_group_time | 是 | datetime | 開團時間 |
pay_amount | 是 | float(2) | 已支付金額 |
is_captain | 是 | int(1) | 是否團長 |
state_name | 是 | string(10) | 訂單狀態(tài) |
group_type_name | 是 | string(10) | 成團階段 |
支持秒殺
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
seckill_price | 是 | float(2) | 秒殺價格 |
pay_amount | 是 | float(2) | 已支付金額 |
state_name | 是 | string(10) | 訂單狀態(tài) |
支持優(yōu)惠券
參數(shù)說明 | 是否必須 | 數(shù)據(jù)類型 | 說明 |
prize_name | 是 | string(60) | 優(yōu)惠券名稱 |
prize_detail | 否 | string(200) | 優(yōu)惠券詳情 |
1.適用于活動類活動，活動參與人，支持投票、圖片合成、圖片生成器、打賞、活動報名、有獎競猜；
2.適用于答題類活動，活動參與人，支持答題、每日一答、趣味答題、猜燈謎、視頻答題、PK答題、考試；
3.使用于游戲類活動，活動參與人，支持游戲、闖關(guān)游戲、養(yǎng)成游戲；
4.適用于裂變類活動，活動參與人裂變統(tǒng)計，支持拆禮盒、集字助力、任務(wù)寶、限時有禮、裂變海報；
5.適用于電商類活動，活動參與人訂單記錄，支持砍價、助力、分銷、拼團、萬人團、秒殺、優(yōu)惠券；
6.適用于節(jié)日類活動，活動參與人，支持許愿樹、孔明燈、心愿池、新年簽、代言海報、節(jié)日頭像、新年Flag；
7.使用于紅包類互動，活動參與人，支持語音紅包、口令紅包；
8.適用于抽獎類活動，活動參與人，抽獎、簽到抽獎、留言抽獎、掃碼抽獎、定時抽獎、VR抽獎、日歷抽獎、口令抽獎、小票抽獎、紅包。抽獎類可通過【活動中獎記錄接口】獲取更多中獎記錄數(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"},
]，
}]
},
"msg": "ok"
}
