排课过程中的常见问题

注册时手机号怎么传？

  • 大陆手机号不需要加区号，即传 15800000001 这样就行
  • 非大陆手机号：00 区号-手机号 例：001-8006437676
  • 注意：手机号首位不能为 0

注册接口报 131-注册失败

  • 原因是同一时间发送了多条相同的请求注册同一个帐号导致，建议同样的请求同一时间只发送一条，接收到返回值之后再根据返回值判断下一步操作

可以将一个账号同时添加为老师和学生吗？

  • 可以将账号同时添加为机构下老师和学生。
  • 但是在一个班级中，同一个账号只能拥有老师或者学生身份，不能同时作为老师和学生
  • 注意：插班生不是班级成员，老师可以是a课节的老师，同时是b课节的插班生。但是不能同时是a课节的老师和插班生。

如果班级里给账号排了主讲的课，成为班级老师，他不能作为学生参加其他课节了怎么办？

  • 如果老师的课节已经结束，可以将账号从班级下老师列表移除（移除课程老师），然后加为学生（添加班级学生）。
  • 如果老师的课还未结束，可以将该账号添加为其他课节的插班生（添加活动成员）。

课程或课节下添加学生报错 228

原因：该账号没有添加到机构下

  • 通过注册接口 +addToSchoolMember 参数完成注册和添加操作。如果手机号码或邮箱已注册 ClassIn，再次调用 register 接口，并传入 addToSchoolMember，仍会返回错误码 1（此时表示将学生/老师添加到机构下成功），同时依然会返回 UID。也可以直接调用添加为学生或者添加老师接口完成。

我们平台排课了为什么 ClassIn 没有看到

ClassIn 后台没看到还是客户端没看到？如果两者都没看到，可能属于下列情况1，或者2，否则按 ClassIn 使用问题处理

  • 情景1： 机构人员在 ClassIn 客户端或者 eeo.cn 操作删除了课节？
  • 情景2： 接口在调用排课接口的时候报错了，但是机构平台没有处理？（可以查阅机构平台日志看看有无报错）
  • 场景3： 课节已经存在了，但是学生没有添加到课节下，导致学生看不到该课节入口。有可能是机构人员从后台或者客户端删除了学生，也可能是机构没有操作添加学生的接口或者接口添加失败

需要机构先确定是哪种场景（从后台、客户端分别查看一下） 如果因为后台操作的话， 建议 API 对接后，不要在 ClassIn 客户端或者 eeo.cn 后台操作，避免造成数据不一致
如果因为 API 接口调用不当，建议机构的技术人员在调用接口时候，只有返回创建成功，才能在平台记录为排课成功。

我们平台删课了为什么 ClassIn 还有

参考上一问

出现了多个相同的课节，如何避免

Q1: 我排了一节课，ClassIn 没有返回，再排一次发现两次都成功了，怎么避免重复？
Q2: 我调用接口排课，返回 280，于是调整录课参数再调一次接口，发现排了两节课，怎么回事？
原因：
Q1可能是接口相同的参数调用了多次，ClassIn 不会根据相同课程或者时间等自动过滤，有多少调用便创建多少节课。
Q2是因为 280 表示建课成功了，如果再次调用创建课节，还会再次创建，造成重复。此时推荐调用这个接口重新设置 设置课节直播回放

解决方案：
创建课节时可以传唯一标识（courseUniqueIdentity）来避免建课重复，如果唯一标识重复会报错，不会创建成功，解决下面两种情况调用导致的重复。

  • 可以解决接口超时重新调用导致的重复
  • 创建课节还有其他返回非1代码，但是课节创建成功了这种情况，包括 280, 281, 824等，需要根据错误码提示修改参数，然后重新创建课节（两次都需要传唯一标识）

删除了课节，重新创建课节的时候报错 398-表示数据已经存在（唯一标识已存在）

  • 创建课节时设置了唯一标识，通过删除课节接口把课节删除之后，这节课的唯一标识可以重新使用；如果是 eeo.cn 或者是在 ClassIn 客户端删除了课节，对应的唯一标识不会被删除，该唯一标识无法再次使用

学生已经添加进机构了，但是 getLoginLinked 提示 150—没有获取该用户登录密钥的权限

原因：该用户该用户不是此课节下的学生、老师、助教或者旁听生

  • 注意：机构账号 或 有监课管理和课程管理的机构子账号 也可以通过此接口获取链接进入教室

创建好课程之后，往课程下添加学生的时候报错841—同步班级昵称失败

  • 这个报错是因为网络原因导致，学生已经添加进该课程下，不过昵称没有同步成功，出现这个报错后可以调用 修改群成员的班级昵称 接口来重新同步昵称
  • 同步班级昵称这一步是在 eeo.cn->学校设置->班级设置 打开了同步班级昵称的设置

怎么通过接口添加插班生和调出生？

  • 插班生：插班生是指插入某一节课下，只能看到插入的这一节课，看不到课程下的其他课节，可以使用 课节下添加学生 接口添加为插班生
  • 调出生：调出生是指本来是课程下的学生，从课程下的某一课节下删除，调出生看不到调出的这节课，可以看到课程下的其他课节，可以使用 课节下删除学生 接口设置为某节课的调出生

启用老师接口返回报错 800-老师被停用中

  • 停用中是操作停用老师之后，还未完成停用的状态。处于停用中的老师无法重新启用，出现这个报错一般等几分钟之后就会变成已停用状态，可以重新启用。

怎样获取邮箱账号的 UID？

  • 使用 注册 接口获取，方法同手机账号

调用接口报错 400-表示请求数据不合法

原因：传的用户的 UID 不对

  • eeo.cn 后台教师管理链接上的 teacherId 和学生管理链接上的 studentId 是关系 ID，不是 UID，账号 UID 只能通过 register 接口获取

怎样修改学生的姓名？怎样让学生在教室内显示机构设置的姓名？

ClassIn 客户端，用户可以自定义昵称，如果没有设置的话，班级学生姓名默认显示这个客户端昵称。

ClassIn 提供了两个接口，用于将学生在机构后台的姓名同步到班级

  • 可以使用 修改群成员的班级昵称 接口，让课程下学生在班级群和教室内显示 eeo.cn 学生管理里设置的姓名（注意，仅调用的时候同步一次；仅对课程下学生或旁听生有效，对插班生无效。）
  • 可以使用同步学生班级昵称 ，使得学生的后台姓名能同步到所有未结束的班级。（注意，仅调用的时候同步一次）

具体方案

    • 方案二： eeo.cn -->学校设置-->班级设置-->打开“同步班级昵称设置”功能--> 编辑学生信息 接口编辑后台学生姓名-->把学生添加为课程下学生
    • 方案三：在管理后台编辑学生信息后，调用同步学生班级昵称 ，使得学生的后台姓名能同步到所有未结束的班级。
  • 注意： 如果管理后台打开同步班级昵称功能，后面学生第一次进班级的时候就会使用当时的机构后台名字为昵称。（但是如果姓名有变化，还是需要调用接口重新同步）

进入直播间打开链接没有自动唤起这个弹窗，是浏览器限制了吗？

  1. 检查是否浏览器限制了弹窗，
  2. 检查是否安装了classin。
  3. 如果安装了ClassIn，可以打开ClassIn，点击系统设置里的注册表修复。

API v2 常见问题

创建单元时报 121601020, 业务参数错误

可能是名字参数的字符过长。

results matching ""

    No results matching ""