修改頻道卡片推送

介面描述

1、修改频道卡片推送，对应新版后台的 营销-卡片
2、接口支持https协议

介面URL

http://api.polyv.net/live/v4/channel/card-push/update

線上API呼叫

請求方式

POST

介面限制

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

2、非必選的請求參數，如果不傳則使用預設項，關聯關係除外（如：conditionUnit欄位在showCondition為WATCH時，需必填）

請求參數描述

請求體參數描述

範例

http://api.polyv.net/live/v4/channel/card-push/update?cardPushId=1282&appId=frlr1zazn3&sign=72F9A8F43AA957F17A8A5CDDB7DC6BA3&channelId=2477096&timestamp=1634268781984

請求體參數：

{
    "duration": "10",
    "conditionUnit": "SECONDS",
    "showCondition": "WATCH",
    "countdownMsg": "测试8个字符成功",
    "link": "http://www.polyv.net",
    "conditionValue": "30",
    "enterEnabled": "Y",
    "title": "测试卡片推送1015",
    "imageType": "giftbox",
    "linkEnabled": "Y"
}

回應參數描述

Error參數描述

Java請求範例

快速接入基礎程式碼請下載相關依賴原始碼， 點擊下載原始碼 ,下載後加入到自己的原始碼工程中即可。測試案例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下載檔案中。

強烈建議您使用直播Java SDK完成API的功能對接，直播Java SDK 對API呼叫邏輯、例外處理、資料簽名、HTTP請求執行緒池進行了統一封裝和最佳化。

/**
 * 测试修改频道卡片推送
 * @throws IOException
 * @throws NoSuchAlgorithmException
 */
@Test
public void testUpdateChannelCardPush() 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/card-push/update";
    
    //http 调用逻辑
    Map<String, String> requestMap = new HashMap<>();
    requestMap.put("appId", appId);
    requestMap.put("timestamp", timestamp);
    requestMap.put("channelId", "2477096");
    requestMap.put("cardPushId", "1282");
    
    Map<String, Object> jsonMap = new HashMap<>();
    jsonMap.put("imageType", "giftbox");
    jsonMap.put("title", "测试卡片推送1015");
    jsonMap.put("link", "http://www.polyv.net");
    jsonMap.put("duration", "10");
    jsonMap.put("showCondition", "WATCH");
    jsonMap.put("conditionValue", "30");
    jsonMap.put("conditionUnit", "SECONDS");
    jsonMap.put("countdownMsg", "测试8个字符成功");
    jsonMap.put("enterEnabled", "Y");
    jsonMap.put("linkEnabled", "Y");
    
    requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
    url = HttpUtil.appendUrl(url, requestMap);
    
    String response = HttpUtil.postJsonBody(url, JSON.toJSONString(jsonMap), null);
    
    log.info("测试修改频道卡片推送成功，返回值：{}", response);
}

回應範例

成功範例

{
    "code": 200,
    "status": "success",
    "requestId": "847f0716fa76461baf8979aaa4415dc3.65.16342687861804037",
    "data": null,
    "success": true
}

異常範例

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