分頁查詢頻道抽獎統計記錄

介面描述

1、分页查询频道抽奖统计记录
2、接口支持https协议

介面URL

http://api.polyv.net/live/v4/channel/lottery/activity-record/list

請求方式

GET

介面限制

1、介面同時支援HTTP、HTTPS，建議使用HTTPS確保介面安全，介面呼叫有頻率限制，詳細請查看

請求參數說明

範例

http://api.polyv.net/live/v4/channel/lottery/activity-record/list?appId=frlr1zazn3&timestamp=1665629374000&sign=6CFA3141718E1AF0155889EEA2988206&channelId=5765904&pageNumber=1

回應說明

Error回應說明

data回應說明

Contents回應說明

SubLotteryList回應說明

LotteryExt回應說明

CollectInfo回應說明

Java請求範例

快速接入基礎程式碼請<span style="color:red">下載相關依賴原始碼</span>， <a href="/third_res/util.zip" target="_blank">點擊下載原始碼</a>，下載後加入到自己的原始碼工程中即可。測試案例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下載檔案中。 > 強烈建議您使用直播Java SDK完成API的功能對接，直播Java SDK 對API呼叫邏輯、異常處理、資料簽名、HTTP請求執行緒池進行了統一封裝和最佳化。

private static final Logger log = LoggerFactory.getLogger(ChannelLotteryTest.class);
/**
 * 分页查询频道抽奖活动统计记录
 * @throws IOException
 * @throws NoSuchAlgorithmException
 */
@Test
public void testPageLotteryActivityRecord() throws IOException, NoSuchAlgorithmException {
    // 公共参数,填写自己的实际参数
    String appId = super.appId;
    String appSecret = super.appSecret;
    String timestamp = String.valueOf(System.currentTimeMillis());

    // 业务参数
    String url = "http://api.polyv.net/live/v4/channel/lottery/activity-record/list";
    Integer channelId = 5765904;
    Integer pageNumber = 1;

    Map<String, String> requestMap = new HashMap<>();
    requestMap.put("appId", appId);
    requestMap.put("timestamp", timestamp);
    requestMap.put("channelId", String.valueOf(channelId));
    requestMap.put("pageNumber", String.valueOf(pageNumber));
    requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));

    String response = HttpUtil.get(url, requestMap);
    log.info("测试分页查询频道抽奖活动统计记录，返回值：{}", response);
    // do somethings
}

回應範例

系統全域錯誤說明詳見全域錯誤說明

成功範例

{
    "code": 200,
    "status": "success",
    "requestId": "48978442-c4a8-4e6d-a08e-cf3fdf6f2c1b",
    "data": {
        "pageNumber": 1,
        "pageSize": 10,
        "totalPages": 2,
        "totalItems": 11,
        "contents": [
            {
                "lotteryId": "h6udiwy1nj",
                "userId": "2b3ccac944",
                "channelId": 5765904,
                "lotteryCondition": "questionnaire",
                "inviteType": null,
                "status": "cancel",
                "createTime": 1745826290000,
                "updateTime": 1745828914000,
                "startTime": 1745996400000,
                "endTime": 1745996460000,
                "lotteryMode": "wait",
                "sessionId": "",
                "activityName": "问卷抽奖",
                "subLotteryList": [
                    {
                        "lotteryId": "h6udixblav",
                        "masterLotteryId": "h6udiwy1nj",
                        "sort": 0,
                        "status": "wait",
                        "channelId": 5765904,
                        "userId": "2b3ccac944",
                        "sessionId": "",
                        "lotteryRange": "notWinning",
                        "actor": null,
                        "prize": "团购券100元",
                        "amount": 1,
                        "preset": "",
                        "ext": "{\"collectInfo\":[{\"type\":\"userName\",\"field\":\"姓名\",\"tips\":\"请输入您的名称\",\"required\":true},{\"type\":\"userPhone\",\"field\":\"手机\",\"tips\":\"请输入您的手机号码\",\"required\":true}]}",
                        "winnerCount": 0,
                        "totalUsers": 0,
                        "createdTime": 1745826290000,
                        "lotteryExt": {
                            "collectInfo": [
                                {
                                    "field": "姓名",
                                    "tips": "请输入您的名称",
                                    "type": "userName",
                                    "required": true
                                },
                                {
                                    "field": "手机",
                                    "tips": "请输入您的手机号码",
                                    "type": "userPhone",
                                    "required": true
                                }
                            ]
                        }
                    },
                    {
                        "lotteryId": "h6udixerdd",
                        "masterLotteryId": "h6udiwy1nj",
                        "sort": 1,
                        "status": "wait",
                        "channelId": 5765904,
                        "userId": "2b3ccac944",
                        "sessionId": "",
                        "lotteryRange": "notWinning",
                        "actor": null,
                        "prize": "团购券50元",
                        "amount": 2,
                        "preset": "",
                        "ext": "{\"collectInfo\":[{\"type\":\"userName\",\"field\":\"姓名\",\"tips\":\"请输入您的名称\",\"required\":true},{\"type\":\"userPhone\",\"field\":\"手机\",\"tips\":\"请输入您的手机号码\",\"required\":true}]}",
                        "winnerCount": 0,
                        "totalUsers": 0,
                        "createdTime": 1745826290000,
                        "lotteryExt": {
                            "collectInfo": [
                                {
                                    "field": "姓名",
                                    "tips": "请输入您的名称",
                                    "type": "userName",
                                    "required": true
                                },
                                {
                                    "field": "手机",
                                    "tips": "请输入您的手机号码",
                                    "type": "userPhone",
                                    "required": true
                                }
                            ]
                        }
                    }
                ]
            },
            {
                "lotteryId": "h6qw06qmx8",
                "userId": "2b3ccac944",
                "channelId": 5765904,
                "lotteryCondition": "none",
                "inviteType": null,
                "status": "finish",
                "createTime": 1745553059000,
                "updateTime": 1745553640000,
                "startTime": 1745553600000,
                "endTime": 1745553630000,
                "lotteryMode": "task",
                "sessionId": "",
                "activityName": "抽奖",
                "subLotteryList": [
                    {
                        "lotteryId": "h6qw06qmx8",
                        "masterLotteryId": "h6qw06qmx8",
                        "sort": 0,
                        "status": "wait",
                        "channelId": 5765904,
                        "userId": "2b3ccac944",
                        "sessionId": "h6que674kh",
                        "lotteryRange": "notWinning",
                        "actor": null,
                        "prize": "苹果",
                        "amount": 1,
                        "preset": "",
                        "ext": "{\"collectInfo\":[{\"field\":\"姓名\",\"tips\":\"请输入您的名称\",\"type\":\"userName\",\"required\":true},{\"field\":\"手机\",\"tips\":\"请输入您的手机号码\",\"type\":\"userPhone\",\"required\":true}]}",
                        "winnerCount": 0,
                        "totalUsers": 0,
                        "createdTime": 1745553600000,
                        "lotteryExt": {
                            "collectInfo": [
                                {
                                    "field": "姓名",
                                    "tips": "请输入您的名称",
                                    "type": "userName",
                                    "required": true
                                },
                                {
                                    "field": "手机",
                                    "tips": "请输入您的手机号码",
                                    "type": "userPhone",
                                    "required": true
                                }
                            ]
                        }
                    }
                ]
            }
        ]
    },
    "success": true
}

異常範例

{
    "code": 400,
    "status": "error",
    "requestId": "d310b70bc329403f87f77f9203d50f89.128.16360831552223589",
    "error": {
        "code": 20001,
        "desc": "application not found."
    },
    "success": false
}