保利威文档中心

幫助中心

service

更新時間:2023-07-11 15:01:53

1、查詢主帳號帳單統計

描述

集团账号查询主账号账单
接口地址(仅做说明使用):https://api.polyv.net/live/v4/group/account/billing-daily/list

呼叫限制

1、API 呼叫有頻率限制,詳細請查看,呼叫常見異常,詳細請查看

單元測試

    @Test
    public void testListBilling() throws IOException, NoSuchAlgorithmException {
        GroupListBillingRequest groupListBillingRequest = new GroupListBillingRequest();
        GroupListBillingResponse groupListBillingResponse;
        try {
            groupListBillingRequest.setBillingDate(super.getDate(2023, 05, 01));
            groupListBillingResponse = new GroupServiceImpl().listBilling(groupListBillingRequest);
            Assert.assertNotNull(groupListBillingResponse);
            if (groupListBillingResponse != null) {
                //to do something ......
                log.debug("测试查询主账号账单统计成功 {}", JSON.toJSONString(groupListBillingResponse));
            }
        } 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、請求正確,回傳 GroupListBillingResponse 物件,B 端依據此物件處理業務邏輯;

2、請求參數驗證不合格,拋出 PloyvSdkException,錯誤訊息見 PloyvSdkException.getMessage(),如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗,失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常,拋出 PloyvSdkException,錯誤訊息見 PloyvSdkException.getMessage(),如 [ 保利威請求回傳資料錯誤,請求流水號:66e7ad29fd04425a84c2b2b562d2025b,錯誤原因: invalid signature. ]

請求入參描述

參數名 必選 類型 說明
billingDate true Date 帳期,格式 yyyyMM,例如 202205,時間需在 202204 之後
pageSize false Integer 每頁資料大小,預設 10,最大值 1000
pageNumber false Integer 當前頁數,預設 1

回傳物件描述

參數名 類型 說明
contents Array 帳單資訊列表【詳見BillingInfo 參數描述
pageSize Integer 每頁顯示的資料筆數,預設每頁顯示 20 筆資料
currentPage Integer 當前頁【對應 API 文件的 pageNumber 欄位】
totalItems Integer 記錄總筆數
totalPage Integer 總頁數【對應 API 文件的 totalPages 欄位】
BillingInfo 參數描述
參數名 類型 說明
unionId String 集團主帳號 ID
accountPeriod String 帳期
production String 產品 雲直播/雲點播
category String 用量類型 雲直播:觀看分鐘數/連麥分鐘數/無延遲分鐘數/導播時長 雲點播:影片播放/儲存空間
itemConsumed Float 用量
itemConsumedUnit String 用量單位
statAt Date 結算日期,天,格式為 yyyy-MM-dd
tradeType Integer 交易類型 1:用量結算 2:金額結算 3:補扣調帳 4:退費調帳

联系客服,在线咨询