userBillService

1. Query User Bill Usage Details

Description

查询用户账单使用详情数据
接口地址（仅做说明使用）：https://api.polyv.net/live//v4/channel/use-detail/list

Call Constraints

1. The API has a call frequency limit. For details, see here. For common call exceptions, see here.

Unit Test

    @Test
    public void testGetBillUseDetailData() throws IOException, NoSuchAlgorithmException {
        LiveGetBillUseDetailRequest liveGetBillUseDetailRequest = new LiveGetBillUseDetailRequest();
        LiveGetBillUseDetailResponse liveGetBillUseDetailResponse;
        try {
            liveGetBillUseDetailRequest.setItemCategory("duration")
                    .setStartDate(super.getDate(2025, 2, 1))
                    .setEndDate(super.getDate(2025, 2, 31));
            liveGetBillUseDetailResponse = new LiveUserBillServiceImpl().getBillUseDetail(liveGetBillUseDetailRequest);
            Assert.assertNotNull(liveGetBillUseDetailResponse);
            if (liveGetBillUseDetailResponse != null) {
                log.debug("测试查询用户账单使用详情数据成功 {}", JSON.toJSONString(liveGetBillUseDetailResponse));
            }
        } 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;
        }
    }
}

Unit Test Description

1. If the request is correct, a LiveGetBillUseDetailResponse object is returned. The B-end processes business logic based on this object.

2. If the request parameter validation fails, a PloyvSdkException is thrown. The error message can be found in PloyvSdkException.getMessage(), e.g., [ Input parameter [xxx.chat.LivexxxRequest] object validation failed, failed fields [pic cannot be empty / msg cannot be empty] ]

3. If the server encounters an exception, a PloyvSdkException is thrown. The error message can be found in PloyvSdkException.getMessage(), e.g., [ Error returned from Polyv request, request serial number: 66e7ad29fd04425a84c2b2b562d2025b, error reason: invalid signature. ]

Request Parameter Description

Return Object Description

BillUseDetail Parameter Description