Polyv Help Center

Help Center

teachService

Updated: 2024-10-21 09:33:43

1. Set Lecturer Single Sign-On Token

Description

讲师单点登录设置token接口
接口地址(仅做说明使用):https://api.polyv.net/hi-class-api/open/teach/v1/set-token

Call Constraints

  1. The API call is subject to rate limits. For details, please refer to [/vclass/java/limit.md]. For common call exceptions, please refer to [/vclass/java/exceptionDoc].

Unit Test

    @Test
    public void testTokenLogin() throws IOException, NoSuchAlgorithmException {
        VClassTokenLoginRequest vClassTokenLoginRequest = new VClassTokenLoginRequest();
        Boolean vClassTokenLoginResponse;
        try {
            vClassTokenLoginRequest.setTeacherId("gmbi29drer");
            vClassTokenLoginRequest.setToken(getRandomString(20, "test"));
            vClassTokenLoginResponse = new VClassTeachServiceImpl().tokenLogin(vClassTokenLoginRequest);
            Assert.assertNotNull(vClassTokenLoginResponse);
            if (vClassTokenLoginResponse != null) {
                //to do something ......
                log.debug("测试讲师单点登录成功 {}", JSON.toJSONString(vClassTokenLoginResponse));
            }
        } 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. Party B 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(), for example: [ Input parameter [xxx.chat.LivexxxRequest] object validation failed, failed fields: [pic cannot be empty / msg cannot be empty] ]

  3. If the server encounters an error during processing, a PloyvSdkException is thrown. The error message can be found in PloyvSdkException.getMessage(), for example: [ Polyv request returned data error, request serial number: 66e7ad29fd04425a84c2b2b562d2025b, error reason: invalid signature. ]

Request Parameter Description

Parameter Required Type Description
teacherId true String Lecturer ID (teacherId)
token true String Single sign-on token, valid for one-time use, expires in one hour

Return Object Description

true indicates successful login, false indicates failed login.

联系客服,在线咨询