活動(dòng)創(chuàng)建接口

請(qǐng)求方式

POST

參數(shù)說明

參數(shù)名稱

是否必須

類型

說明

app_key

是

string(32)

人人秀平臺(tái)分配的AppKey

time_stamp

是

int(11)

1970-01-01開始的時(shí)間戳，精確到毫秒

sign

是

string(32)

根據(jù)簽名算法計(jì)算所得，如何計(jì)算簽名

login_id

是

string(60)

登錄賬號(hào)，指定賬號(hào)下活動(dòng)。   查看賬號(hào) 

tpl_team_guid

否

string(6)

團(tuán)隊(duì)模板GUID，根據(jù)模板創(chuàng)建，通過模板接口獲取

type

否

int(11)

團(tuán)隊(duì)模板為空時(shí)必傳，創(chuàng)建空白活動(dòng)，type活動(dòng)類型枚舉，1：H5；2：互動(dòng)（抽獎(jiǎng)）；3：活動(dòng)專題；4：文章；5：海報(bào)

share_info

否

obj

設(shè)置活動(dòng)分享信息

open_setting

否

obj

設(shè)置活動(dòng)基本設(shè)置，互動(dòng)類型支持

title

否

string(200)

活動(dòng)分享標(biāo)題

describe

否

string(200)

活動(dòng)分享描述

share_image_url

否

string(200)

圖片地址，會(huì)下載到人人秀

start_time

否

datetime

互動(dòng)活動(dòng)開始時(shí)間，格式例如2024-01-01 00:00:00

end_time

否

datetime

互動(dòng)活動(dòng)結(jié)束時(shí)間，格式例如2099-10-10 23:59:59

open_mp

否

int(2)

開啟關(guān)注公眾號(hào)參與，1：開啟

open_grab

否

int(2)

開啟抽獎(jiǎng)，1：開啟，僅游戲類、答題類活動(dòng)支持

grab_limit

否

int(11)

開啟抽獎(jiǎng)條件，滿足xx分可抽獎(jiǎng)

grab_prize_list

否

array

新增抽獎(jiǎng)列表管理

open_points

否

int(2)

開啟積分參與，1：開啟

points

否

int(11)

開啟積分參與，每次消耗積分值

rule_content

否

text

活動(dòng)規(guī)則，支持富文本，圖片不支持下載到人人秀

auto_show_rule

否

int(2)

是否自動(dòng)彈出活動(dòng)規(guī)則顯示

open_forms

否

int(2)

開啟報(bào)名表單，1：開啟

forms_list

否

array

報(bào)名表單列表

open_grab_later

否

int(2)

開啟領(lǐng)獎(jiǎng)后關(guān)注，1：開啟（僅支持開啟抽獎(jiǎng)?lì)惢顒?dòng)）

later_info

否

array

領(lǐng)獎(jiǎng)后事件

open_top_prize

否

int(2)

開啟排行榜獎(jiǎng)品，1：開啟（僅游戲、答題類活動(dòng)支持）

top_prize_list

否

array

排行榜獎(jiǎng)品列表

get_prize_list

否

array

任務(wù)領(lǐng)獎(jiǎng)獎(jiǎng)品設(shè)置（支持日歷抽獎(jiǎng)、任務(wù)寶、拆禮盒、集字助力活動(dòng)）

open_black

否

int(2)

開啟禁止黑名單用戶參與，1：開啟

open_sys_black

否

int(2)

開啟禁止系統(tǒng)不量用戶參與，1：開啟

title

是

string(60)

獎(jiǎng)品顯示名稱

type

是

int(11)

獎(jiǎng)品類型枚舉，1：實(shí)物獎(jiǎng)品；2：紅包獎(jiǎng)品；6：積分獎(jiǎng)品；7：自有獎(jiǎng)品；0：非獎(jiǎng)品

prize_image_url

否

string(200)

圖片地址，會(huì)下載到人人秀

prize_code

否

string(10)

type=7時(shí)，自有獎(jiǎng)品必傳，建議對(duì)接自有獎(jiǎng)品庫（需單獨(dú)按需開啟）

prize_links

否

obj

type=7時(shí)，自有獎(jiǎng)品自定義跳轉(zhuǎn)鏈接，非API模式必傳

prize_points

否

int(11)

type=6時(shí)，積分獎(jiǎng)品必傳，建議對(duì)接自有積分接口（需單獨(dú)按需開啟）

prize_redpack

否

obj

type=2時(shí)，紅包獎(jiǎng)品必傳

prize_win_rate

是

float(2)

獎(jiǎng)品中獎(jiǎng)概率（0.01~100），所有獎(jiǎng)品總概率不超過100

prize_count

是

int(11)

獎(jiǎng)品數(shù)量

is_consolation

否

int(2)

安慰獎(jiǎng)，僅支持一個(gè)，安慰獎(jiǎng)不參與計(jì)算中獎(jiǎng)概率

send_type

否

int(11)

配送方式,1:直接領(lǐng)??；2：快遞發(fā)貨；3：線下核銷

redpack_type

是

int(11)

紅包類型枚舉，1：固定金額；2：隨機(jī)金額

redpack_amount

否

float(2)

選擇固定金額時(shí)，必須，金額范圍（0.1 ~ 200）,小于1元紅包需單獨(dú)按需開啟

redpack_min_amount

否

float(2)

選擇隨機(jī)金額時(shí)，必須，單筆隨機(jī)的最小金額,金額范圍（0.1~200）

redpack_max_amount

否

float(2)

選擇隨機(jī)金額時(shí)，必須，單筆隨機(jī)的最大金額,必須大于最小金額，金額范圍（0.1~200）

redpack_total_amount

否

float(2)

選擇隨機(jī)金額時(shí)，必傳，該獎(jiǎng)品總發(fā)放金額

type

是

int(2)

自有獎(jiǎng)品類型，1：跳轉(zhuǎn)鏈接；2：跳轉(zhuǎn)小程序

links

否

string(60)

type=1，必傳，跳轉(zhuǎn)的自定義鏈接

appid

否

string(20)

type=2，必傳，跳轉(zhuǎn)的小程序APPID

path

否

string(60)

type=2，可傳，跳轉(zhuǎn)的小程序頁面路徑，默認(rèn)首頁

type

是

int(2)

關(guān)注類型，1：關(guān)注二維碼；2：跳轉(zhuǎn)鏈接；3：跳轉(zhuǎn)小程序

title

是

string(60)

引導(dǎo)標(biāo)題

message

是

string(200)

引導(dǎo)文案

image_src

否

string(60)

type=1，必傳，關(guān)注的二維碼圖片地址

btn_text

否

string(10)

type=2或type=3，可傳，引導(dǎo)按鈕文案

link

否

string(60)

type=2，必傳，跳轉(zhuǎn)的鏈接地址

appid

否

string(20)

type=3，必傳，跳轉(zhuǎn)的小程序APPID

path

否

string(60)

type=3，可傳，跳轉(zhuǎn)的小程序頁面路徑，默認(rèn)首頁

title

是

string(20)

字段顯示標(biāo)題

type

是

string(10)

字段類型枚舉：姓名、手機(jī)號(hào)、收貨信息、文本、多行文本、下拉框

values

否

string(200)

type=下拉框，必傳，選項(xiàng)值多個(gè)逗號(hào)分割

is_must

否

int(2)

是否必填，1：必填

is_sms

否

int(2)

type=手機(jī)號(hào)，可用，1：開啟短信驗(yàn)證

is_only

否

int(2)

type=手機(jī)號(hào)，可用，1：開啟手機(jī)號(hào)唯一

is_delete

否

int(2)

是否標(biāo)記刪除

title

是

string(20)

獎(jiǎng)品顯示名稱

type

是

int(11)

獎(jiǎng)品類型枚舉，1：實(shí)物獎(jiǎng)；2：紅包獎(jiǎng)品；6：積分獎(jiǎng)品；7：自有獎(jiǎng)品；0：非獎(jiǎng)品

prize_image_url

否

string(200)

圖片地址，會(huì)下載到人人秀

prize_code

否

string(10)

type=7，自有獎(jiǎng)品,開啟API必傳 

pirze_links

否

obj

type=7,自有獎(jiǎng)品，非API必傳，自定義跳轉(zhuǎn)

prize_points

否

int(11)

type=6，積分獎(jiǎng)品，積分分值

prize_redpack

否

obj

type=2，紅包獎(jiǎng)品，必傳

send_type

否

int(2)

配送方式，1：直接領(lǐng)??；2：快遞發(fā)貨；3：線下核銷

top_num

是

int(11)

該獎(jiǎng)品發(fā)獎(jiǎng)排行榜開始排名值

top_end_num

是

int(11)

該獎(jiǎng)品發(fā)獎(jiǎng)排行榜結(jié)束排名值

title

是

string(20)

獎(jiǎng)品顯示名稱

type

是

int(11)

獎(jiǎng)品類型枚舉，1：實(shí)物獎(jiǎng)；2：紅包獎(jiǎng)品；6：積分獎(jiǎng)品；7：自有獎(jiǎng)品；0：非獎(jiǎng)品

prize_image_url

否

string(200)

圖片地址，會(huì)下載到人人秀

prize_code

否

string(10)

type=7，自有獎(jiǎng)品,開啟API必傳 

pirze_links

否

obj

type=7,自有獎(jiǎng)品，非API必傳，自定義跳轉(zhuǎn)

prize_points

否

int(11)

type=6，積分獎(jiǎng)品，積分分值

prize_redpack

否

obj

type=2，紅包獎(jiǎng)品，必傳

send_type

否

int(2)

配送方式，1：直接領(lǐng)??；2：快遞發(fā)貨；3：線下核銷

prize_num

是

int(11)

獎(jiǎng)品總數(shù)量

get_task_num

是

int(11)

領(lǐng)取要求（對(duì)應(yīng)活動(dòng)獎(jiǎng)品條件：目標(biāo)人數(shù)、兌換條件、助力人數(shù)、簽到天數(shù)等）

get_task_type

否

int(11)

日歷抽獎(jiǎng)玩法，任務(wù)類型，1：連續(xù)簽到；2：累計(jì)簽到

{"result":0,"msg":"","data":{"h5_guid":"","url":""}}

參與名稱

類型

說明

result

int(2)

0表示成功，1表示失敗

msg

string(100)

失敗時(shí)，返回的錯(cuò)誤描述

data

obj

詳情見data參數(shù)說明

url

string(100)

編輯活動(dòng)地址

h5_guid

string(6)

作品GUID

prize_list

obj

活動(dòng)設(shè)置的獎(jiǎng)品列表

grab_prize_list

obj

抽獎(jiǎng)獎(jiǎng)品列表，詳見上面 grab_prize_list 參數(shù)說明

top_prize_list

obj

排行榜獎(jiǎng)品列表，詳見上面 top_prize_list 參數(shù)說明

get_prize_list

obj

領(lǐng)獎(jiǎng)獎(jiǎng)品列表，詳見上面 get_prize_list 參數(shù)說明