teachService
1. Set Lecturer Single Sign-On Token
Description
讲师单点登录设置token接口
接口地址(仅做说明使用):https://api.polyv.net/hi-class-api/open/teach/v1/set-token
Call Constraints
- 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
If the request is correct, a Boolean object is returned. Party B processes business logic based on this object.
If request parameter validation fails, a
PloyvSdkExceptionis thrown. The error message can be found inPloyvSdkException.getMessage(), for example: [ Input parameter [xxx.chat.LivexxxRequest] object validation failed, failed fields: [pic cannot be empty / msg cannot be empty] ]If the server encounters an error during processing, a
PloyvSdkExceptionis thrown. The error message can be found inPloyvSdkException.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.
