查询频道页面装修

接口描述

1、查询频道的页面装修设置
2、接口支持https协议

接口URL

http://api.polyv.net/live/v4/channel/decorate/get

在线API调用

请求方式

GET

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

请求参数描述

示例

http://api.polyv.net/live/v4/channel/decorate/get?appId=frlr1zacn3&sign=0F412B15C2DC032517E1D29BD4452C43&channelId=2523307&timestamp=1630996829815

响应参数描述

Error参数描述

data参数描述

TemplateDecorateChatBO参数描述

TemplateDecorateDescBO参数描述

TemplateDecorateDescEnBO参数描述

TemplateDecorateMenuBO参数描述

TemplateDecoratePlayerBO参数描述

TemplateDecorateSplashBO参数描述

Java请求示例

快速接入基础代码请下载相关依赖源码， 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。

强烈建议您使用直播Java SDK完成API的功能对接，直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。

    private static final Logger log = LoggerFactory.getLogger(ChannelDecorateTest.class);
    
    @Test
    public void getChannelDecorate() 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/decorate/get";
        
        //http 调用逻辑
        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("appId", appId);
        requestMap.put("timestamp", timestamp);
        requestMap.put("channelId", "2523307");
        
        requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
        
        String response = HttpUtil.get(url,requestMap);
        
        log.info("测试修改频道装修设置，返回值：{}", response);
    }

响应示例

成功示例

{
    "code": 200,
    "status": "success",
    "requestId": "dc7ae621ef8e4f4a8e4976833f1dbbd4.66.16309975070362179",
    "data": {
        "skin": "red",
        "aloneWatchLayout": "normal",
        "pptMobileWatchLayout": "normal",
        "englishSettingEnabled": "Y",
        "player": {
            "watermarkEnabled": null,
            "iconUrl": "//liveimages.videocc.net/uploaded/images/2021/09/g24vjlhywx.png",
            "iconPosition": "br",
            "logoOpacity": 1,
            "iconLink": "",
            "basePV": 6,
            "actualPV": 21,
            "warmUpEnabled": "Y",
            "warmUpImageUrl": "http://liveimages.videocc.net/uploadimage/20210312/chat_img_1b448be323_16155164629438.jpeg",
            "coverJumpUrl": "",
            "backgroundUrl": ""
        },
        "desc": {
            "coverImageUrl": "http://liveimages.videocc.net/uploadimage/20210312/chat_img_1b448be323_16155164629438.jpeg",
            "iconUrl": "http://liveimages.videocc.net/assets/wimages/pc_images/logo.png",
            "title": "polyv宣讲会",
            "publisher": "polyv专用主持人"
        },
        "descEn": null,
        "chat": {
            "sendFlowersEnabled": "N",
            "baseLikes": 800,
            "withdrawEnabled": "N",
            "redPackEnabled": "N",
            "chatOnlineNumberEnable": "N",
            "viewerSendImgEnabled": "N",
            "welcomeEnabled": "N",
            "emotionEnabled": "N"
        },
        "menus": [
            {
                "menuId": "1435122684833112066",
                "name": "直播间描述",
                "type": "desc",
                "content": null
            },
            {
                "menuId": "1435122684837306369",
                "name": "聊天",
                "type": "chat",
                "content": null
            }
        ],
        "enMenus": [
            {
                "menuId": "1435080554799091714",
                "name": "desc",
                "type": "desc",
                "content": null
            },
            {
                "menuId": "1435132950782222337",
                "name": "talk",
                "type": "chat",
                "content": null
            }
        ],
        "splash": {
            "splashImageUrl": ""
        },
        "splashEnabled": "Y"
    },
    "success": true
}

异常示例

{
    "code": 400,
    "status": "error",
    "requestId": "d310b70bc329403f87f77f9203d50f89.128.16360828899123425",
    "error": {
        "code": 30004,
        "desc": "找不到频道"
    },
    "success": false
}