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:退費調帳 |
