查詢預設範本打賞設定

介面描述

1、查询直播模板打赏设置，包括现金打赏、礼物打赏，礼物打赏又分为现金支付和积分支付
2、接口支持https协议

介面URL

http://api.polyv.net/live/v4/user/donate/get

線上API呼叫

請求方式

GET

介面限制

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

請求參數說明

範例

http://api.polyv.net/live/v4/user/donate/get?appId=frlr1zazn3&sign=0EEE910FFD45B0DCD4A71D490DEB83D6&timestamp=1631091211556

回應參數說明

Error參數說明

data參數說明

TemplateCashDonateBO參數說明

TemplateGiftDonateBO參數說明

GiftDonate參數說明

Java請求範例

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

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

    private static final Logger log = LoggerFactory.getLogger(UserDonateTest.class);

    @Test
    public void getUserDonate() 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/user/donate/get";
        
        //http 调用逻辑
        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("appId", appId);
        requestMap.put("timestamp", timestamp);
        
        requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
        
        String response = HttpUtil.get(url,requestMap);
        
        log.info("测试查询直播模板打赏设置，返回值：{}", response);
    }

回應範例

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

成功範例

{
    "code": 200,
    "status": "success",
    "requestId": "4b38eabb79824a409e7fd149f03425d7.73.16708091734594439",
    "data": {
        "donateCashEnabled": "Y",
        "donateGiftEnabled": "Y",
        "cashDonate": {
            "cashs": [
                0.81,
                6.62,
                8.83,
                18.84,
                66.65,
                88.86
            ],
            "cashMin": 0.02
        },
        "giftDonate": {
            "payWay": "POINT",
            "cashUnit": null,
            "pointUnit": "polyv积分",
            "cashPays": [
                {
                    "name": "金手指",
                    "img": "",
                    "dynamicImg": "//liveimages.videocc.net/uploaded/images/2022/12/gg94fabgsb.png",
                    "dynamicFile": "https://liveimages.videocc.net/uploaded/files/1b448be323/2022/12/gg932fa78u.svga",
                    "price": 1.11,
                    "sequence": 0,
                    "enabled": "Y",
                    "unit": null,
                    "imgType": "DYNAMIC"
                },
                {
                    "name": "红玫瑰",
                    "img": "//liveimages.videocc.net/uploaded/images/2021/11/g41in083xo.png",
                    "dynamicImg": null,
                    "dynamicFile": null,
                    "price": 6.66,
                    "sequence": 1,
                    "enabled": "Y",
                    "unit": null,
                    "imgType": null
                }
            ],
            "pointPays": [
                {
                    "name": "666",
                    "img": "//s1.videocc.net/default-img/donate/666.png",
                    "dynamicImg": null,
                    "dynamicFile": null,
                    "price": 12.88,
                    "sequence": 0,
                    "enabled": "Y",
                    "unit": null,
                    "imgType": null
                },
                {
                    "name": "恭喜发财",
                    "img": "https://liveimages.videocc.net/uploaded/images/2021/11/g4b3010gmm.gif",
                    "dynamicImg": null,
                    "dynamicFile": null,
                    "price": 66.88,
                    "sequence": 1,
                    "enabled": "Y",
                    "unit": null,
                    "imgType": null
                }
            ]
        }
    },
    "success": true
}

異常範例

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