lotteryActivityService

1、查询抽奖活动

描述

查询抽奖活动
接口地址（仅做说明使用）：https://api.polyv.net/live//v4/channel/lottery-activity/get

调用约束

1、接口调用有频率限制，详细请查看，调用常见异常，详细请查看

单元测试

    @Test
    public void testGetLotteryActivity() throws Exception, NoSuchAlgorithmException {
        LiveLotteryActivityRequest liveLotteryActivityRequest = new LiveLotteryActivityRequest();
        LiveLotteryActivityResponse liveLotteryActivityResponse;
        try {
            liveLotteryActivityRequest.setChannelId(super.createChannel()).setId(30632L);
            liveLotteryActivityResponse = new LiveLotteryActivityServiceImpl().getLotteryActivity(
                    liveLotteryActivityRequest);
            Assert.assertNotNull(liveLotteryActivityResponse);
            if (liveLotteryActivityResponse != null) {
                //to do something ......
                log.debug("测试查询抽奖活动成功，{}", JSON.toJSONString(liveLotteryActivityResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

单元测试说明

1、请求正确，返回LiveLotteryActivityResponse对象，B端依据此对象处理业务逻辑；

2、请求参数校验不合格，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败，失败字段 [pic不能为空 / msg不能为空] ]

3、服务器处理异常，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 保利威请求返回数据错误，请求流水号：66e7ad29fd04425a84c2b2b562d2025b，错误原因： invalid signature. ]

请求入参描述

返回对象描述

CustomGroup参数描述

ReceiveInfo参数描述

ReceiveInfo参数描述

PrizeInfo参数描述

ReceiveInfo参数描述

2、创建抽奖活动

描述

创建抽奖活动
接口地址（仅做说明使用）：https://api.polyv.net/live//v4/channel/lottery-activity/create

调用约束

1、接口调用有频率限制，详细请查看，调用常见异常，详细请查看

单元测试

    @Test
    public void testCreateLotteryActivity() throws Exception, NoSuchAlgorithmException {
        LiveCreateLotteryActivityRequest liveCreateLotteryActivityRequest = new LiveCreateLotteryActivityRequest();
        LiveCreateLotteryActivityResponse liveCreateLotteryActivityResponse;
        try {
            liveCreateLotteryActivityRequest.setChannelId(super.createChannel())
                    .setActivityName("polyv抽奖活动")
                    .setLotteryCondition("none")
                    .setAmount(1)
                    .setPrizeName("一等奖")
                    .setPrice(BigDecimal.valueOf(12.1))
                    .setRealPrice(BigDecimal.valueOf(200.33));
            liveCreateLotteryActivityResponse = new LiveLotteryActivityServiceImpl().createLotteryActivity(
                    liveCreateLotteryActivityRequest);
            Assert.assertNotNull(liveCreateLotteryActivityResponse);
            if (liveCreateLotteryActivityResponse != null) {
                //to do something ......
                log.debug("测试创建抽奖活动成功，{}", JSON.toJSONString(liveCreateLotteryActivityResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

单元测试说明

1、请求正确，返回LiveCreateLotteryActivityResponse对象，B端依据此对象处理业务逻辑；

2、请求参数校验不合格，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败，失败字段 [pic不能为空 / msg不能为空] ]

3、服务器处理异常，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 保利威请求返回数据错误，请求流水号：66e7ad29fd04425a84c2b2b562d2025b，错误原因： invalid signature. ]

请求入参描述

ReceiveInfo参数描述

ReceiveInfo参数描述

PrizeInfo参数描述

ReceiveInfo参数描述

返回对象描述

CustomGroup参数描述

ReceiveInfo参数描述

ReceiveInfo参数描述

PrizeInfo参数描述

ReceiveInfo参数描述

3、更新抽奖活动

描述

更新抽奖活动
接口地址（仅做说明使用）：https://api.polyv.net/live//v4/channel/lottery-activity/update

调用约束

1、接口调用有频率限制，详细请查看，调用常见异常，详细请查看

单元测试

    @Test
    public void testUpdateLotteryActivity() throws Exception, NoSuchAlgorithmException {
        LiveUpdateLotteryActivityRequest liveUpdateLotteryActivityRequest = new LiveUpdateLotteryActivityRequest();
        Boolean liveUpdateLotteryActivityResponse;
        try {
            liveUpdateLotteryActivityRequest.setChannelId(super.createChannel())
                    .setId(30951L)
                    .setActivityName("polyv抽奖活动")
                    .setLotteryCondition("none")
                    .setAmount(2)
                    .setPrizeName("2等奖");
            liveUpdateLotteryActivityResponse = new LiveLotteryActivityServiceImpl().updateLotteryActivity(
                    liveUpdateLotteryActivityRequest);
            Assert.assertNotNull(liveUpdateLotteryActivityResponse);
            if (liveUpdateLotteryActivityResponse != null) {
                //to do something ......
                log.debug("更新抽奖活动成功，{}", JSON.toJSONString(liveUpdateLotteryActivityResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

单元测试说明

1、请求正确，返回Boolean对象，B端依据此对象处理业务逻辑；

2、请求参数校验不合格，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败，失败字段 [pic不能为空 / msg不能为空] ]

3、服务器处理异常，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 保利威请求返回数据错误，请求流水号：66e7ad29fd04425a84c2b2b562d2025b，错误原因： invalid signature. ]

请求入参描述

ReceiveInfo参数描述

ReceiveInfo参数描述

PrizeInfo参数描述

ReceiveInfo参数描述

返回对象描述

null

4、删除抽奖活动

描述

删除抽奖活动
接口地址（仅做说明使用）：https://api.polyv.net/live//v4/channel/lottery-activity/delete

调用约束

1、接口调用有频率限制，详细请查看，调用常见异常，详细请查看

单元测试

    @Test
    public void testDeleteLotteryActivity() throws Exception, NoSuchAlgorithmException {
        LiveDeleteLotteryActivityRequest liveDeleteLotteryActivityRequest = new LiveDeleteLotteryActivityRequest();
        Boolean liveDeleteLotteryActivityResponse;
        try {
            liveDeleteLotteryActivityRequest.setChannelId(super.createChannel())
                    .setId(30951L);
            liveDeleteLotteryActivityResponse = new LiveLotteryActivityServiceImpl().deleteLotteryActivity(
                    liveDeleteLotteryActivityRequest);
            Assert.assertNotNull(liveDeleteLotteryActivityResponse);
            if (liveDeleteLotteryActivityResponse != null) {
                //to do something ......
                log.debug("删除抽奖活动成功，{}", JSON.toJSONString(liveDeleteLotteryActivityResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

单元测试说明

1、请求正确，返回Boolean对象，B端依据此对象处理业务逻辑；

2、请求参数校验不合格，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败，失败字段 [pic不能为空 / msg不能为空] ]

3、服务器处理异常，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 保利威请求返回数据错误，请求流水号：66e7ad29fd04425a84c2b2b562d2025b，错误原因： invalid signature. ]

请求入参描述

返回对象描述

null

5、查询抽奖活动列表

描述

查询抽奖活动列表
接口地址（仅做说明使用）：https://api.polyv.net/live//v4/channel/lottery-activity/list

调用约束

1、接口调用有频率限制，详细请查看，调用常见异常，详细请查看

单元测试

    @Test
    public void testListLotteryActivity() throws IOException, NoSuchAlgorithmException {
        LiveLotteryActivityListRequest liveLotteryActivityListRequest = new LiveLotteryActivityListRequest();
        LiveLotteryActivityListPageResponse liveLotteryActivityListPageResponse;
        try {
            liveLotteryActivityListRequest.setChannelId(super.createChannel()).setPageSize(2);
            liveLotteryActivityListPageResponse = new LiveLotteryActivityServiceImpl().listLotteryActivity(
                    liveLotteryActivityListRequest);
            Assert.assertNotNull(liveLotteryActivityListPageResponse);
            if (liveLotteryActivityListPageResponse != null) {
                //to do something ......
                log.debug("查询抽奖活动列表成功，{}", JSON.toJSONString(liveLotteryActivityListPageResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }
}

单元测试说明

1、请求正确，返回LiveLotteryActivityListPageResponse对象，B端依据此对象处理业务逻辑；

2、请求参数校验不合格，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败，失败字段 [pic不能为空 / msg不能为空] ]

3、服务器处理异常，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 保利威请求返回数据错误，请求流水号：66e7ad29fd04425a84c2b2b562d2025b，错误原因： invalid signature. ]

请求入参描述

返回对象描述

LiveLotteryActivityList参数描述

CustomGroup参数描述

ReceiveInfo参数描述

ReceiveInfo参数描述

PrizeInfo参数描述

ReceiveInfo参数描述