使用方式

一、開始抽獎活動

Api 方法： startLuckyLottery(activityId: number): Promise<CommonResult<string, Object>>

參數說明：

• activityId：活動ID，number 類型，必傳

回傳值說明： Promise<CommonResult<string, Object>> 類型

範例：

const result = await luckyLotteryTarget.startLuckyLottery(123);
if (result.success) {
  console.log('抽奖成功', result.data);
} else {
  console.error('抽奖失败', result.failReason);
}

二、取得幸運抽獎活動列表

Api 方法： getLuckyLotteryActivityList(options?: PageOptions): Promise<PageContent<LuckyLotteryActivityItem>>

參數說明：

• options：分頁參數，PageOptions 類型，選傳，預設 {}，詳細類型說明如下

回傳值說明： 分頁資料，Promise<PageContent<LuckyLotteryActivityItem>> 類型，詳細類型說明如下

範例：

const data = await luckyLotteryTarget.getLuckyLotteryActivityList({ pageNumber: 1, pageSize: 10 });
console.log('幸运抽奖活动列表', data.contents);

三、取得幸運抽獎活動詳情

Api 方法： getLuckyLotteryActivityById(activityId: number): Promise<LuckyLotteryActivityDetailData>

參數說明：

• activityId：活動ID，number 類型，必傳

回傳值說明： Promise<LuckyLotteryActivityDetailData> 類型，詳細類型說明如下

範例：

const data = await luckyLotteryTarget.getLuckyLotteryActivityById(123);
console.log('幸运抽奖活动详情', data);

四、取得中獎者列表

Api 方法： getLuckyLotteryWinnersList(options: PageOptions & Object): Promise<PageContent<LuckyLotteryWinnersItem>>

參數說明：

• options：分頁參數，包含分頁資訊和活動ID，PageOptions & Object 類型，必傳

回傳值說明： 分頁資料，Promise<PageContent<LuckyLotteryWinnersItem>> 類型，詳細類型說明如下

範例：

const data = await luckyLotteryTarget.getLuckyLotteryWinnersList({
  pageNumber: 1,
  pageSize: 10,
  taskId: 123
});
console.log('中奖者列表', data.contents);

五、取得幸運抽獎中獎記錄

Api 方法： getLuckyLotteryPrizeList(options?: PageOptions): Promise<PageContent<LuckyLotteryPrizeItem>>

參數說明：

• options：取得參數，包含分頁資訊，PageOptions 類型，選傳，預設 {}，詳細類型說明如下

回傳值說明： 分頁資料，Promise<PageContent<LuckyLotteryPrizeItem>> 類型，詳細類型說明如下

範例：

const data = await luckyLotteryTarget.getLuckyLotteryPrizeList({
  pageNumber: 1,
  pageSize: 10
});
console.log('奖品列表', data.contents);

六、取得中獎領取資訊

Api 方法： getLuckyLotteryReceive(recordId: number): Promise<LuckyLotteryReceiveData>

參數說明：

• recordId：中獎記錄行 ID，number 類型，必傳

回傳值說明： Promise<LuckyLotteryReceiveData> 類型，詳細類型說明如下

範例：

const data = await luckyLotteryTarget.getLuckyLotteryReceive(123);
console.log('中奖领取信息', data);

七、提交中獎領取資訊

Api 方法： submitLuckyLotteryReceive(options: LuckyLotterySubmitReceiveOptions): Promise<unknown>

參數說明：

• options：提交參數，LuckyLotterySubmitReceiveOptions 類型，必傳，詳細類型說明如下

回傳值說明： Promise<unknown> 類型

範例：

await luckyLotteryTarget.submitLuckyLotteryReceive({
  taskId: 123,
  recordId: 123,
  collectItems: [{ field: '姓名', type: 'text', tips: '请输入姓名', required: true, value: '张三' }],
});
toast('提交成功');