accountService
更新時間:2023-09-22 17:47:34
1、查詢使用者空間及流量情況
描述
通过日期查询用户账号的空间及流量使用情况
接口地址(仅做说明使用):https://api.polyv.net/v2/user/%s/main
呼叫限制
1、介面呼叫有頻率限制,詳細請查看,呼叫常見異常,詳細請查看
單元測試
@Test
public void testGetAccountSpaceFlow() throws Exception, NoSuchAlgorithmException {
VodAccountSpaceDataRequest vodAccountSpaceDataRequest = new VodAccountSpaceDataRequest();
VodAccountSpaceDataResponse vodAccountSpaceDataResponse;
try {
vodAccountSpaceDataRequest.setDate(super.getDate(2020, 10, 13));
vodAccountSpaceDataResponse = new VodAccountServiceImpl().getAccountSpaceFlow(vodAccountSpaceDataRequest);
Assert.assertNotNull(vodAccountSpaceDataResponse);
if (vodAccountSpaceDataResponse != null) {
log.debug("测试查询用户空间及流量情况成功,{}", JSON.toJSONString(vodAccountSpaceDataResponse));
}
} 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、請求正確,回傳VodAccountSpaceDataResponse物件,B端依據此物件處理業務邏輯;
2、請求參數驗證不合格,拋出PloyvSdkException,錯誤訊息見PloyvSdkException.getMessage(),如 [ 輸入參數 [xxx.chat.VodxxxRequest]物件驗證失敗,失敗欄位 [pic不能為空 / msg不能為空] ]
3、伺服器處理異常,拋出PloyvSdkException,錯誤訊息見PloyvSdkException.getMessage(),如 [ 保利威請求回傳資料錯誤,請求流水號:66e7ad29fd04425a84c2b2b562d2025b,錯誤原因:invalid signature. ]
請求參數說明
| 參數名 | 必填 | 類型 | 說明 |
|---|---|---|---|
| date | false | Date | 要查詢的日期,格式 :yyyy-MM-dd |
回傳物件說明
| 參數名 | 類型 | 說明 |
|---|---|---|
| totalFlow | Long | 使用者總流量,單位為byte |
| usedSpace | Long | 已用空間,單位為byte |
| usedFlow | Long | 已用流量,單位為byte |
| totalSpace | Long | 使用者總空間,單位為byte |
| userId | String | POLYV使用者ID |
| String | POLYV使用者信箱 |
