保利威文档中心

帮助中心

service

更新时间:2023-07-11 15:01:53

1、查询主账号账单统计

描述

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

调用约束

1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看

单元测试

    @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:退费调账

联系客服,在线咨询