保利威文档中心

幫助中心

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
email String POLYV使用者信箱

联系客服,在线咨询