排课过程中的常见问题

注册时手机号怎么传？

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

注册接口报 131-注册失败

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

课程或课节下添加学生报错 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-老师被停用中

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

创建课节报错 454 课节起止时间与系统维护时间有重叠

  • 原因：课节的开始和结束时间（包括开课前的20分钟和拖堂的20分钟）与系统维护时间重叠导致，例如：2023-3-21 00:31-05:29 维护，创建的课节的上课时间不能和 2023-3-21 00:10-05:50 重叠
  • 每次维护小助手会提前在售后群里通知，固定维护时间可以参考如下链接 https://docs.eeo.cn/product/zh-hans/function/System/Maintainance.html

getLoginLinked 接口获取唤起客户端链接返回报错 467-唤起客户端仅支持手机账号，请先绑定手机号

邮箱账号不支持网页唤起客户端，必须绑定手机号之后才能使用网页唤起，建议需要网页唤起客户端功能的使用手机号注册账号

注意：

  • 如果要使用网页唤起客户端功能，邮箱账号必须绑定手机号之后才能使用此功能
  • 绑定手机号的操作只能用户登录客户端后操作，无法通过接口绑定
  • 账号注册后每次登录都会检测登录地点，大陆范围内登录邮箱账号，如果之前没有验证手机号，需要填写手机号通过短信验证才能登录使用
  • 一个手机号可以验证5个账号，即：一个手机号可以验证4个邮箱账号和绑定一个邮箱账号

邮箱账号怎么通过网页唤起客户端（未绑定手机号）？

未绑定手机号的邮箱账号无法通过 获取唤醒客户端并进入教室链接 接口获取唤起客户端链接，可以通过拼接链接唤起

怎样获取邮箱账号的 UID？

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

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

原因：传的用户的 UID 不对

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

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

  • 可以使用 修改群成员的班级昵称 接口，让课程下学生在班级群和教室内显示 eeo.cn 学生管理里设置的姓名

  • 方案一：编辑学生信息 接口编辑后台学生姓名-->把学生添加为课程下学生--> 修改群成员的班级昵称 接口同步班级昵称

  • 方案二： eeo.cn -->学校设置-->班级设置-->打开“同步班级昵称设置”功能--> 编辑学生信息 接口编辑后台学生姓名-->把学生添加为课程下学生

  • 注意：“修改群成员的班级昵称”接口仅对课程下学生或旁听生有效

API v2 常见问题

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

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

results matching ""

    No results matching ""