userService

1. Query Sub-Account List and Remaining Resources

Description

集团账号查询分账号列表及分账号剩余资源
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/group/user/package/list

Call Constraints

1. API calls are rate-limited. Click here for details. For common call exceptions, click here.

Unit Test

    @Test
    public void testListPackage() throws IOException, NoSuchAlgorithmException {
        GroupListPackageRequest groupListPackageRequest = new GroupListPackageRequest();
        GroupListPackageResponse groupListPackageResponse;
        try {
            groupListPackageResponse = new UserServiceImpl().listPackage(groupListPackageRequest);
            Assert.assertNotNull(groupListPackageResponse);
            if (groupListPackageResponse != null) {
                //to do something ......
                log.debug("测试查询分账号列表及剩余资源成功 {}", JSON.toJSONString(groupListPackageResponse));
            }
        } 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 GroupListPackageResponse object is returned. The B-end processes business logic based on this object.

2. If 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 field [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., [Polyv request returned data error, request serial number: 66e7ad29fd04425a84c2b2b562d2025b, error reason: invalid signature.]

Request Parameter Description

Response Object Description

Package Parameter Description

2. Create Group Sub-Account

Description

创建集团分帐号
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/group/user/create

Call Constraints

1. API calls are rate-limited. Click here for details. For common call exceptions, click here.

Unit Test

    @Test
    public void testCreate() throws IOException, NoSuchAlgorithmException {
        GroupCreateUserRequest groupCreateUserRequest = new GroupCreateUserRequest();
        GroupCreateUserResponse groupCreateUserResponse;
        try {
            groupCreateUserRequest.setEmail("polyvtest0707@polyv.net");
            groupCreateUserRequest.setPassword("polyvtest0707");
            groupCreateUserRequest.setContacts("张三");
            groupCreateUserRequest.setPhone("17600002222");
            groupCreateUserRequest.setExpireDate(super.getDate(1688720314000L));
            groupCreateUserRequest.setMaxChannels(1);
            groupCreateUserRequest.setConcurrent(10);
            groupCreateUserResponse = new UserServiceImpl().create(groupCreateUserRequest);
            Assert.assertNotNull(groupCreateUserResponse);
            if (groupCreateUserResponse != null) {
                //to do something ......
                log.debug("测试创建集团分帐号成功 {}", JSON.toJSONString(groupCreateUserResponse));
            }
        } 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 GroupCreateUserResponse object is returned. The B-end processes business logic based on this object.

2. If 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 field [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., [Polyv request returned data error, request serial number: 66e7ad29fd04425a84c2b2b562d2025b, error reason: invalid signature.]

Request Parameter Description

Response Object Description

3. Allocate Sub-Account Resources

Description

分配分帐号资源
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/group/user/package/update

Call Constraints

1. API calls are rate-limited. Click here for details. For common call exceptions, click here.

Unit Test

    @Test
    public void testUpdatePackage() throws IOException, NoSuchAlgorithmException {
        GroupUpdatePackageRequest groupUpdatePackageRequest = new GroupUpdatePackageRequest();
        Boolean groupUpdatePackageResponse;
        try {
            groupUpdatePackageRequest.setEmail("polyvtest0625@polyv.net");
            groupUpdatePackageRequest.setBalance(2f);
            groupUpdatePackageRequest.setConcurrent(5);
            groupUpdatePackageRequest.setRemainFlow(10);
            groupUpdatePackageRequest.setRemainSpace(10);
            groupUpdatePackageResponse = new UserServiceImpl().updatePackage(groupUpdatePackageRequest);
            Assert.assertNotNull(groupUpdatePackageResponse);
            if (groupUpdatePackageResponse != null) {
                //to do something ......
                log.debug("测试分配分帐号资源成功 {}", JSON.toJSONString(groupUpdatePackageResponse));
            }
        } 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 Boolean object is returned. The B-end processes business logic based on this object.

2. If 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 field [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., [Polyv request returned data error, request serial number: 66e7ad29fd04425a84c2b2b562d2025b, error reason: invalid signature.]

Request Parameter Description

Response Object Description

true indicates successful allocation, false indicates failed allocation.