Web Interact

1、设置道具打赏

描述

设置道具打赏
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/donate/update-good

调用约束

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

单元测试

	@Test
	public void testUpdateChannelGood() throws Exception, NoSuchAlgorithmException {
        LiveUpdateChannelGoodRequest liveUpdateChannelGoodRequest = new LiveUpdateChannelGoodRequest();
        Boolean liveUpdateChannelGoodResponse;
        try {
            List<LiveUpdateChannelGoodRequest.ChannelGood> channelGoods =
                    new ArrayList<LiveUpdateChannelGoodRequest.ChannelGood>();
            LiveUpdateChannelGoodRequest.ChannelGood channelGood = new LiveUpdateChannelGoodRequest.ChannelGood();
            channelGood.setGoodName("佛跳墙")
                    .setGoodImg("//livestatic.videocc.net/uploaded/images/webapp/channel/donate/07-diamond.png")
                    .setGoodPrice(9999.99)
                    .setGoodEnabled("Y");
            channelGoods.add(channelGood);
            liveUpdateChannelGoodRequest.setChannelId(createChannel()).setEnabled("Y").setGoods(channelGoods);
            liveUpdateChannelGoodResponse = new LiveWebInteractServiceImpl().updateChannelGood(
                    liveUpdateChannelGoodRequest);
            Assert.assertNotNull(liveUpdateChannelGoodResponse);
            if (liveUpdateChannelGoodResponse) {
                //to do something ......
                log.debug("测试设置道具打赏成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	false	String	频道号，不传为全局设置
enabled	false	String	请求体参数，道具打赏开关，不传默认开启，值为 Y/N , Y为开启
goods	true	Array	道具打赏，道具对象数量必须大于0小于10【详见ChannelGood参数描述】

ChannelGood参数描述

参数名	必选	类型	说明
goodName	true	String	道具名称，不能超过5个字符
goodImg	true	String	道具图片，不能超过120个字符（通过上传图片接口上传获取图片地址，或者使用默认地址;鲜花：01-flower.png;咖啡:02-coffee.png;点赞:03-good.png;掌声:04-applaud.png;666:05-666.png;小星星:06-star.png;钻石:07-diamond.png;跑车:08-car.png;火箭:09-rocket.png;前缀统一为：//livestatic.videocc.net/uploaded/images/webapp/channel/donate/）
goodPrice	true	Double	道具打赏价格
goodEnabled	true	String	道具开关，值为 Y/N , Y为开启

返回对象描述

true代表设置成功，false代表设置失败

---

2、设置现金打赏

描述

用于设置频道或者全局现金打赏
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/donate/update-cash

调用约束

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

2、带上频道号为设置频道现金打赏，不带频道号默认为全局现金打赏设置

单元测试

	@Test
	public void testUpdateChannelCash() throws Exception, NoSuchAlgorithmException {
        LiveUpdateChannelCashRequest liveUpdateChannelCashRequest = new LiveUpdateChannelCashRequest();
        Boolean liveUpdateChannelCashResponse;
        try {
            Double[] floats = {0.88d, 6.66d, 8.88d, 18.11d, 66.60d, 88.89d};
            List<Double> cashes = Arrays.asList(floats);
            liveUpdateChannelCashRequest.setChannelId(createChannel())
                    .setCashes(cashes)
                    .setCashMin(0.02d)
                    .setEnabled("Y");
            liveUpdateChannelCashResponse = new LiveWebInteractServiceImpl().updateChannelCash(
                    liveUpdateChannelCashRequest);
            Assert.assertNotNull(liveUpdateChannelCashResponse);
            if (liveUpdateChannelCashResponse) {
                //to do something ......
                log.debug("测试设置现金打赏成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	false	String	频道号，不传为全局设置
cashes	true	Array	请求体参数，现金打赏数额数组，数组的长度必须为6
cashMin	true	Double	请求体参数，现金打赏自定义最小金额
enabled	false	String	请求体参数，现金打赏开关，不传默认开启，值为 Y/N , Y为开启

返回对象描述

true表示设置成功，false表示设置失败

---

3、查询打赏设置

描述

查询打赏设置
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/donate/get

调用约束

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

单元测试

	@Test
	public void testGetChannelDonate() throws Exception, NoSuchAlgorithmException {
        LiveChannelDonateRequest liveChannelDonateRequest = new LiveChannelDonateRequest();
        LiveChannelDonateResponse liveChannelDonateResponse;
        try {
            liveChannelDonateRequest.setChannelId(createChannel());
            liveChannelDonateResponse = new LiveWebInteractServiceImpl().getChannelDonate(liveChannelDonateRequest);
            Assert.assertNotNull(liveChannelDonateResponse);
            if (liveChannelDonateResponse != null) {
                //to do something ......
                log.debug("测试查询打赏设置成功,{}", JSON.toJSONString(liveChannelDonateResponse));
            }
        } 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、请求正确，返回LiveChannelDonateResponse对象，B端依据此对象处理业务逻辑；

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

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

请求入参描述

参数名	必选	类型	说明
channelId	false	String	频道号，不传为获取全局设置

返回对象描述

参数名	类型	说明
globalSettingEnabled	String	是否应用全局设置，获取全局设置时，该值为null
donateCashEnabled	String	现金打赏开关
donateGoodEnabled	String	道具打赏开关
donateTips	String	打赏提示
cashes	Array	请求体参数，现金打赏数额数组，数组的长度必须为6
cashMin	Double	请求体参数，现金打赏自定义最小金额
goods	Array	道具打赏【详见ChannelGood参数描述】

ChannelGood参数描述

参数名	类型	说明
goodName	String	道具名称，不能超过5个字符
goodImg	String	道具图片，不能超过120个字符（通过上传图片接口上传获取图片地址，或者使用默认地址;鲜花：01-flower.png;咖啡:02-coffee.png;点赞:03-good.png;掌声:04-applaud.png;666:05-666.png;小星星:06-star.png;钻石:07-diamond.png;跑车:08-car.png;火箭:09-rocket.png;前缀统一为：//livestatic.videocc.net/uploaded/images/webapp/channel/donate/）
goodPrice	Double	道具打赏价格
goodEnabled	String	道具开关，值为 Y/N , Y为开启

---

4、设置频道微信分享信息

描述

用于修改频道的微信分享相关设置
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/weixin-share/update

调用约束

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

单元测试

	@Test
	public void testUpdateChannelWxShare() throws Exception, NoSuchAlgorithmException {
        LiveUpdateChannelWxShareRequest liveUpdateChannelWxShareRequest = new LiveUpdateChannelWxShareRequest();
        Boolean liveUpdateChannelWxShareResponse;
        try {
            liveUpdateChannelWxShareRequest.setChannelId(createChannel())
                    .setWxShareTitle("Mysql 知识精讲")
                    .setWxShareDesc("带你走进Mysql的奇妙世界");
            liveUpdateChannelWxShareResponse = new LiveWebInteractServiceImpl().updateChannelWxShare(
                    liveUpdateChannelWxShareRequest);
            Assert.assertTrue(liveUpdateChannelWxShareResponse);
            if (liveUpdateChannelWxShareResponse) {
                //to do something ......
                log.debug("测试设置频道微信分享信息成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
wxShareTitle	false	String	微信分享的标题（30字符内）【对应api文档的weixinShareTitle字段】
wxShareDesc	false	String	微信分享的描述（120字符内）【对应api文档的weixinShareDesc字段】

返回对象描述

true为设置成功，false为设置失败

---

5、查询频道微信分享信息

描述

获取频道的微信分享设置信息
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/weixin-share/get

调用约束

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

单元测试

	@Test
	public void testGetChannelWxShare() throws Exception, NoSuchAlgorithmException {
        LiveGetChannelWxShareRequest liveGetChannelWxShareRequest = new LiveGetChannelWxShareRequest();
        LiveGetChannelWxShareResponse liveGetChannelWxShareResponse;
        try {
            liveGetChannelWxShareRequest.setChannelId(createChannel());
            liveGetChannelWxShareResponse = new LiveWebInteractServiceImpl().getChannelWxShare(
                    liveGetChannelWxShareRequest);
            Assert.assertNotNull(liveGetChannelWxShareResponse);
            if (liveGetChannelWxShareResponse != null) {
                //to do something ......
                log.debug("测试查询频道微信分享信息成功，{}", JSON.toJSONString(liveGetChannelWxShareResponse));
            }
        } 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、请求正确，返回LiveGetChannelWxShareResponse对象，B端依据此对象处理业务逻辑；

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

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

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号

返回对象描述

参数名	类型	说明
channelId	String	频道号
channelName	String	频道名称
coverImg	String	微信分享图标，即频道的直播图标
wxShareTitle	String	微信分享的标题【对应api文档的weixinShareTitle字段】
wxShareDesc	String	微信分享的描述【对应api文档的weixinShareDesc字段】

---

6、查询频道打赏设置

描述

查询频道打赏设置，包括现金打赏、礼物打赏，礼物打赏又分为现金支付和积分支付
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/user/donate/get

调用约束

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

单元测试

	@Test
	public void testGetChannelDonateV2() throws IOException, NoSuchAlgorithmException {
        LiveGetChannelDonateRequest liveGetChannelDonateRequest = new LiveGetChannelDonateRequest();
        LiveGetChannelDonateResponse liveGetChannelDonateResponse;
        try {
            String channelId = super.createChannel();
            liveGetChannelDonateRequest.setChannelId(channelId);
            liveGetChannelDonateResponse = new LiveWebInteractServiceImpl().getChannelDonateV2(
                    liveGetChannelDonateRequest);
            Assert.assertNotNull(liveGetChannelDonateResponse);
            if (liveGetChannelDonateResponse != null) {
                //to do something ......
                log.debug("测试查询频道打赏设置成功{}", JSON.toJSONString(liveGetChannelDonateResponse));
            }
        } 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、请求正确，返回LiveGetChannelDonateResponse对象，B端依据此对象处理业务逻辑；

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

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

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号

返回对象描述

参数名	类型	说明
donateCashEnabled	String	现金红包打赏开关，Y：开启，N：关闭
cashDonate	ChannelCashDonate	现金红包【详见ChannelCashDonate参数描述】
donateGiftEnabled	String	礼物打赏开关，Y：开启，N：关闭
giftDonate	Array	礼物打赏（现金支付或积分支付）【详见ChannelGiftDonate参数描述】

ChannelCashDonate参数描述

参数名	类型	说明
cashes	Array	固定打赏金额，数组长度在1-6，最小值0.01，最大值9999.99【对应api文档的cashs字段】
cashMin	Float	自定义打赏金额-最低金额，最小值0.01，最大值9999.99

ChannelGiftDonate参数描述

参数名	类型	说明
payWay	String	支付方式，CASH：现金支付，POINT：积分支付
cashUnit	String	现金单位
pointUnit	String	积分单位
cashPays	Array	现金支付列表【详见ChannelGift参数描述】
pointPays	Array	积分支付列表【详见ChannelGift参数描述】

ChannelGift参数描述

参数名	类型	说明
name	String	礼物名称
img	String	礼物图片地址
price	Float	礼物价格
enabled	String	开关，Y：开启，N：关闭

ChannelGift参数描述

参数名	类型	说明
name	String	礼物名称
img	String	礼物图片地址
price	Float	礼物价格
enabled	String	开关，Y：开启，N：关闭

---

7、修改频道礼物打赏设置

描述

修改频道礼物打赏设置，礼物打赏又分为现金支付和积分支付
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/donate/gift/update

调用约束

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

单元测试

	@Test
	public void testUpdateChannelDonateV2() throws IOException, NoSuchAlgorithmException {
        LiveUpdateChannelDonateRequest liveUpdateChannelDonateRequest = new LiveUpdateChannelDonateRequest();
        Boolean liveUpdateChannelDonateResponse;
        try {
            LiveUpdateChannelDonateRequest.ChannelGiftDonate giftDonate =
                    new LiveUpdateChannelDonateRequest.ChannelGiftDonate();
            List<LiveUpdateChannelDonateRequest.ChannelGift> giftList = new ArrayList<>();
            LiveUpdateChannelDonateRequest.ChannelGift gift1 = new LiveUpdateChannelDonateRequest.ChannelGift();
            gift1.setImg("//liveimages.videocc.net/uploaded/images/2021/11/g41in083xo.png")
                    .setName("现金礼物1")
                    .setPrice(Float.valueOf("66.66"))
                    .setEnabled(LiveConstant.Flag.YES.getFlag());
            giftList.add(gift1);
            List<LiveUpdateChannelDonateRequest.ChannelGift> pointList = new ArrayList<>();
            LiveUpdateChannelDonateRequest.ChannelGift gift2 = new LiveUpdateChannelDonateRequest.ChannelGift();
            gift2.setImg("//s1.videocc.net/default-img/donate/666.png")
                    .setName("积分礼物1")
                    .setPrice(Float.valueOf("88.88"))
                    .setEnabled(LiveConstant.Flag.YES.getFlag());
            pointList.add(gift2);
            giftDonate.setPayWay(LiveConstant.PayWay.CASH.getValue())
                    .setCashPays(giftList)
                    .setPointPays(pointList)
                    .setPointUnit("polyv积分");
            liveUpdateChannelDonateRequest.setGiftDonate(giftDonate);
            liveUpdateChannelDonateRequest.setDonateGiftEnabled(LiveConstant.Flag.YES.getFlag());
            liveUpdateChannelDonateRequest.setChannelId(super.createChannel());
            liveUpdateChannelDonateResponse = new LiveWebInteractServiceImpl().updateChannelDonateV2(
                    liveUpdateChannelDonateRequest);
            Assert.assertTrue(liveUpdateChannelDonateResponse);
            if (liveUpdateChannelDonateResponse) {
                //to do something ......
                log.debug("测试修改频道礼物打赏设置成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
donateGiftEnabled	false	String	礼物打赏开关，Y：开启，N：关闭
giftDonate	false	ChannelGiftDonate	礼物打赏（现金支付或积分支付）【详见ChannelGiftDonate参数描述】

ChannelGiftDonate参数描述

参数名	必选	类型	说明
payWay	false	String	支付方式，CASH：现金支付，POINT：积分支付
cashUnit	false	String	现金单位
pointUnit	false	String	积分单位
cashPays	false	Array	现金支付列表【详见ChannelGift参数描述】
pointPays	false	Array	积分支付列表【详见ChannelGift参数描述】

ChannelGift参数描述

参数名	必选	类型	说明
name	false	String	礼物名称
img	false	String	礼物图片地址
price	false	Float	礼物价格
enabled	false	String	开关，Y：开启，N：关闭

ChannelGift参数描述

参数名	必选	类型	说明
name	false	String	礼物名称
img	false	String	礼物图片地址
price	false	Float	礼物价格
enabled	false	String	开关，Y：开启，N：关闭

返回对象描述

修改频道礼物打赏设置返回实体

---

8、查询频道卡片推送

描述

查询频道卡片推送，对应新版后台的 营销-卡片
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/card-push/list

调用约束

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

单元测试

	@Test
	public void testGetChannelCardPush() throws IOException, NoSuchAlgorithmException {
        LiveGetChannelCardPushRequest liveGetChannelCardPushRequest = new LiveGetChannelCardPushRequest();
        List<LiveGetChannelCardPushResponse> liveGetChannelCardPushResponse;
        try {
            String channelId = super.createChannel();
            liveGetChannelCardPushRequest.setChannelId(channelId);
            liveGetChannelCardPushResponse = new LiveWebInteractServiceImpl().getChannelCardPush(
                    liveGetChannelCardPushRequest);
            Assert.assertNotNull(liveGetChannelCardPushResponse);
            if (liveGetChannelCardPushResponse != null) {
                //to do something ......
                log.debug("测试查询频道卡片推送成功{}", JSON.toJSONString(liveGetChannelCardPushResponse));
            }
        } 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、请求正确，返回LiveGetChannelCardPushResponse对象，B端依据此对象处理业务逻辑；

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

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

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道ID

返回对象描述

返回对象是List<LiveGetChannelCardPushResponse>，LiveGetChannelCardPushResponse具体元素内容如下：

参数名	类型	说明
id	Long	卡片推送主键ID
channelId	String	频道ID
title	String	卡片标题，最多16个字符
imageType	String	卡片样式类型，giftbox：礼物领取样式，redpack：红包样式
duration	Integer	卡片倒计时时长，取值：0,5,10,20,30，单位：秒，0为不显示倒计时时长
link	String	卡片跳转链接地址，带http://等协议头
pushEndTime	Date	推送结束时间
createdTime	Date	创建时间
lastModified	Date	修改时间
pushStatus	String	推送状态Y.推送中、N.未推送、L.上次推送
pushTime	Date	推送时间
enterEnabled	String	卡片入口Y.开启、N.关闭
showCondition	String	弹出方式，PUSH.推送后立即弹出、WATCH.观看后弹出
conditionValue	Integer	观看时长
conditionUnit	String	观看时长单位SECONDS.秒、MINUTES.分钟
countdownMsg	String	倒计时文案，showCondition为WATCH时生效，最多8个字符

---

9、创建频道卡片推送

描述

创建频道卡片推送，对应新版后台的 营销-卡片
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/card-push/create

调用约束

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

单元测试

	@Test
	public void testCreateChannelCardPush() throws IOException, NoSuchAlgorithmException {
        LiveCreateChannelCardPushRequest liveCreateChannelCardPushRequest = new LiveCreateChannelCardPushRequest();
        LiveCreateChannelCardPushResponse liveCreateChannelCardPushResponse;
        try {
            String channelId = super.createChannel();
            liveCreateChannelCardPushRequest.setChannelId(channelId)
                    .setTitle("测试SDK卡片推送")
                    .setLink("http://polyv.net")
                    .setImageType(LiveConstant.ImageType.GIFT_BOX.getValue())
                    .setDuration(LiveConstant.CardPushDuration.DURATION_TEN.getValue())
                    .setShowCondition(LiveConstant.ShowCondition.WATCH.getValue())
                    .setConditionValue(10)
                    .setConditionUnit(LiveConstant.ConditionUnit.SECONDS.getValue())
                    .setCountdownMsg("倒计时")
                    .setEnterEnabled(LiveConstant.Flag.YES.getFlag());
            liveCreateChannelCardPushResponse = new LiveWebInteractServiceImpl().createChannelCardPush(
                    liveCreateChannelCardPushRequest);
            Assert.assertNotNull(liveCreateChannelCardPushResponse);
            if (liveCreateChannelCardPushResponse != null) {
                //to do something ......
                log.debug("测试创建频道卡片推送成功{}", JSON.toJSONString(liveCreateChannelCardPushResponse));
                //TODO 此处创建完成后删除了卡片推送，正式使用需删除该语句
                super.deleteChannelPushCard(channelId, liveCreateChannelCardPushResponse.getId());
            }
        } 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、请求正确，返回LiveCreateChannelCardPushResponse对象，B端依据此对象处理业务逻辑；

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

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

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
imageType	true	String	卡片样式类型，giftbox：礼物领取样式，redpack：红包样式
title	true	String	卡片标题，最多16个字符
link	true	String	卡片跳转链接地址，需要带http:等协议头
duration	true	Integer	卡片倒计时时长，取值：0,5,10,20,30，单位：秒，0为不显示倒计时时长
showCondition	true	String	弹出方式，PUSH：推送后立即弹出、WATCH：观看后弹出
conditionValue	false	Integer	观看后弹出的观看时长，showCondition为WATCH时生效
conditionUnit	false	String	观看后弹出的观看时长单位SECONDS.秒、MINUTES.分钟，showCondition为WATCH时，该值生效且必填
countdownMsg	false	String	倒计时文案，showCondition为WATCH时生效，最多8个字符
enterEnabled	true	String	卡片入口开关Y.开启、N.关闭

返回对象描述

参数名	类型	说明
id	Long	卡片推送主键ID
channelId	String	频道ID
title	String	卡片标题，最多16个字符
imageType	String	卡片样式类型，giftbox：礼物领取样式，redpack：红包样式
duration	Integer	卡片倒计时时长，取值：0,5,10,20,30，单位：秒，0为不显示倒计时时长
link	String	卡片跳转链接地址，带http:等协议头
pushEndTime	Date	推送结束时间
createdTime	Date	创建时间
lastModified	Date	修改时间
pushStatus	String	推送状态Y.推送中、N.未推送、L.上次推送
pushTime	Date	推送时间
enterEnabled	String	卡片入口Y.开启、N.关闭
showCondition	String	弹出方式，PUSH.推送后立即弹出、WATCH.观看后弹出
conditionValue	Integer	观看时长
conditionUnit	String	观看时长单位SECONDS.秒、MINUTES.分钟
countdownMsg	String	倒计时文案，showCondition为WATCH时生效，最多8个字符

---

10、修改频道卡片推送

描述

修改频道卡片推送，对应新版后台的 营销-卡片
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/card-push/update

调用约束

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

单元测试

	@Test
	public void testUpdateChannelCardPush() throws IOException, NoSuchAlgorithmException {
        LiveUpdateChannelCardPushRequest liveUpdateChannelCardPushRequest = new LiveUpdateChannelCardPushRequest();
        Boolean liveUpdateChannelCardPushResponse;
        try {
            String channelId = super.createChannel();
            liveUpdateChannelCardPushRequest.setChannelId(channelId)
                    .setCardPushId(super.getChannelCardPushId(channelId))
                    .setTitle("测试SDK修改卡片推送")
                    .setLink("https://polyv.net");
            liveUpdateChannelCardPushResponse = new LiveWebInteractServiceImpl().updateChannelCardPush(
                    liveUpdateChannelCardPushRequest);
            Assert.assertTrue(liveUpdateChannelCardPushResponse);
            if (liveUpdateChannelCardPushResponse) {
                //to do something ......
                log.debug("测试修改频道卡片推送成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
cardPushId	true	Long	卡片推送主键ID
imageType	false	String	卡片样式类型，giftbox：礼物领取样式，redpack：红包样式
title	false	String	卡片标题，最多16个字符
link	false	String	卡片跳转链接地址，需要带http:等协议头
duration	false	Integer	卡片倒计时时长，取值：0,5,10,20,30，单位：秒，0为不显示倒计时时长
showCondition	false	String	弹出方式，PUSH：推送后立即弹出、WATCH：观看后弹出
conditionValue	false	Integer	观看后弹出的观看时长，showCondition为WATCH时生效
conditionUnit	false	String	观看后弹出的观看时长单位SECONDS.秒、MINUTES.分钟，showCondition为WATCH时，该值生效且必填
countdownMsg	false	String	倒计时文案，showCondition为WATCH时生效，最多8个字符
enterEnabled	false	String	卡片入口开关Y.开启、N.关闭

返回对象描述

修改频道卡片推送返回实体

---

11、删除卡片推送

描述

删除卡片推送，对应新版后台的 营销-卡片
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/card-push/delete

调用约束

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

单元测试

	@Test
	public void testDeleteChannelCardPush() throws IOException, NoSuchAlgorithmException {
        LiveDeleteChannelCardPushRequest liveDeleteChannelCardPushRequest = new LiveDeleteChannelCardPushRequest();
        Boolean liveDeleteChannelCardPushResponse;
        try {
            String channelId = super.createChannel();
            liveDeleteChannelCardPushRequest.setChannelId(channelId)
                    .setCardPushId(super.getChannelCardPushId(channelId));
            liveDeleteChannelCardPushResponse = new LiveWebInteractServiceImpl().deleteChannelCardPush(
                    liveDeleteChannelCardPushRequest);
            Assert.assertTrue(liveDeleteChannelCardPushResponse);
            if (liveDeleteChannelCardPushResponse) {
                //to do something ......
                log.debug("测试删除卡片推送成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
cardPushId	true	Long	卡片推送主键ID

返回对象描述

删除卡片推送返回实体

---

12、推送频道卡片

描述

推送频道卡片，对应新版后台的 营销-卡片
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/card-push/push

调用约束

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

单元测试

	@Test
	public void testPushChannelCardPush() throws IOException, NoSuchAlgorithmException {
        LivePushChannelCardPushRequest livePushChannelCardPushRequest = new LivePushChannelCardPushRequest();
        Boolean livePushChannelCardPushResponse;
        try {
            String channelId = super.createChannel();
            Long cardPushId = super.getChannelCardPushId(channelId);
            livePushChannelCardPushRequest.setChannelId(channelId).setCardPushId(cardPushId);
            livePushChannelCardPushResponse = new LiveWebInteractServiceImpl().pushChannelCardPush(
                    livePushChannelCardPushRequest);
            Assert.assertTrue(livePushChannelCardPushResponse);
            if (livePushChannelCardPushResponse) {
                //to do something ......
                log.debug("测试推送频道卡片成功");
                //TODO 此处创建完成后删除了卡片推送，正式使用需删除该语句
                super.deleteChannelPushCard(channelId, cardPushId);
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
cardPushId	true	Long	卡片推送主键ID

返回对象描述

推送频道卡片返回实体

---

13、取消推送卡片

描述

取消推送卡片，对应新版后台的 营销-卡片
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/card-push/cancel-push

调用约束

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

单元测试

	@Test
	public void testCancelPushChannelCardPush() throws IOException, NoSuchAlgorithmException {
        LiveCancelPushChannelCardPushRequest liveCancelPushChannelCardPushRequest =
                new LiveCancelPushChannelCardPushRequest();
        Boolean liveCancelPushChannelCardPushResponse;
        try {
            String channelId = super.createChannel();
            liveCancelPushChannelCardPushRequest.setChannelId(channelId)
                    .setCardPushId(super.getChannelPushingCardId(channelId));
            liveCancelPushChannelCardPushResponse = new LiveWebInteractServiceImpl().cancelPushChannelCardPush(
                    liveCancelPushChannelCardPushRequest);
            Assert.assertTrue(liveCancelPushChannelCardPushResponse);
            if (liveCancelPushChannelCardPushResponse) {
                //to do something ......
                log.debug("测试取消推送卡片成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
cardPushId	true	Long	卡片推送主键ID

返回对象描述

取消推送卡片返回实体

---

14、查询频道微信分享信息

描述

查询频道微信分享信息
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/share/get

调用约束

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

单元测试

	@Test
	public void testGetChannelShare() throws IOException, NoSuchAlgorithmException {
        LiveGetChannelShareRequest liveGetChannelShareRequest = new LiveGetChannelShareRequest();
        LiveGetChannelShareResponse liveGetChannelShareResponse;
        try {
            String channelId = super.createChannel();
            liveGetChannelShareRequest.setChannelId(channelId);
            liveGetChannelShareResponse = new LiveWebInteractServiceImpl().getChannelShare(liveGetChannelShareRequest);
            Assert.assertNotNull(liveGetChannelShareResponse);
            if (liveGetChannelShareResponse != null) {
                //to do something ......
                log.debug("测试查询频道微信分享信息成功{}", JSON.toJSONString(liveGetChannelShareResponse));
            }
        } 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、请求正确，返回LiveGetChannelShareResponse对象，B端依据此对象处理业务逻辑；

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

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

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号

返回对象描述

参数名	类型	说明
shareBtnEnable	String	是否开启分享，Y：开启，N：关闭
titleType	String	标题类型follow直播标题、custom自定义
weixinShareTitle	String	分享标题，最大长度50，标题类型为custom时，该字段生效
weixinShareDesc	String	分享简介，最大长度120，标题类型为custom时，该字段生效
weixinShareCustomUrl	String	微信自定义分享地址，最大长度512
webShareCustomUrl	String	网页观看自定义分享地址，最大长度512

---

15、修改频道微信分享信息

描述

修改频道微信分享信息，对应新版后台的 营销-分享设置
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/share/update

调用约束

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

单元测试

	@Test
	public void testUpdateChannelShare() throws IOException, NoSuchAlgorithmException {
        LiveUpdateChannelShareRequest liveUpdateChannelShareRequest = new LiveUpdateChannelShareRequest();
        Boolean liveUpdateChannelShareResponse;
        try {
            String channelId = super.createChannel();
            liveUpdateChannelShareRequest.setChannelId(channelId)
                    .setShareBtnEnable(LiveConstant.Flag.YES.getFlag())
                    .setTitleType(LiveConstant.TitleType.FOLLOW.getValue());
            liveUpdateChannelShareResponse = new LiveWebInteractServiceImpl().updateChannelShare(
                    liveUpdateChannelShareRequest);
            Assert.assertTrue(liveUpdateChannelShareResponse);
            if (liveUpdateChannelShareResponse) {
                //to do something ......
                log.debug("测试修改频道微信分享信息成功");
            }
        } 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. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
shareBtnEnable	true	String	是否开启分享，Y：开启，N：关闭
titleType	true	String	标题类型follow直播标题、custom自定义
weixinShareTitle	false	String	分享标题，最大长度50，标题类型为custom时，该字段必填
weixinShareDesc	false	String	分享简介，最大长度120，标题类型为custom时，该字段必填
weixinShareCustomUrl	false	String	微信自定义分享地址，最大长度512，链接必须带协议，如：https://，链接需要进行encode
webShareCustomUrl	false	String	网页观看自定义分享地址，最大长度512，链接必须带协议，如：https://，链接需要进行encode

返回对象描述

修改频道微信分享信息返回实体