修订记录

置顶通知，请认真阅读。从 2020 年 06 月 08 日起：

1） 为了能够支持更换ClassIn账号手机号码，下述接口将只支持传参uid，不再支持传参手机号码。您需要在上述截止日期之前，完成：

  • 修改您的API对接代码，把传参手机号码改为传参uid（相关涉及的接口，新增 400 错误码，表示请求数据不合法（即uid不存在或者uid不属于该机构学生或者老师））；
  • 在您的数据库里，需要保存手机号码和uid之间的对应关系。您可以调用接口 register（注册用户） 以获取已注册用户的 UID 信息，无论手机号是否注册过，接口均会返回data=xxxx ，这个data后面的数字xxxx即为用户UID。您需要将这个UID保存，以完成相关表数值的初始化。

涉及的接口包括：修改用户昵称，修改用户密码，停用老师，启用老师，更新课节教师对学生评价，创建课程，编辑课程，创建课节（单个），创建课节（多个），修改课节信息，课程下添加学生/旁听（单个），课程下删除学生/旁听（单个），课程下添加学生/旁听（多个），课程下删除学生/旁听（多个），课节下添加学生（多个），课节下删除学生（多个），更换课程老师，移除课程老师，课程下多个课节添加学生，获取唤醒客户端并进入教室链接

请注意：接口 添加学生 和 添加老师, 仅支持传参手机号码，不支持传参uid。

2）接口域名及协议头：

  • 测试环境 对接 ClassIn SDK API 的用户需要将 root_url 替换为 api.classin-sdk.com

  • 正式环境 对接 ClassIn SDK API 的用户需要将 root_url 替换为 api.classinpaas.com

  • 所有接口 URL 协议头请使用 https，如果您继续使用 http 方式的话，则会收到 403 状态码。

另外，为了便于后期新接口以及重要修改的通知，强烈建议您在 认证资料 里填写您的常用邮箱（入口：登录eeo.cn机构管理后台，点击左侧的认证资料页面进行填写）。

3.13 2021年1月12日

接口 创建课节（单个） 、接口 创建课节（多个） 、接口 修改课节上台学生数 新增api参数isDc，支持设置双摄像头

3.12 2020年11月15日

3.11 2020年08月13日

接口 创建课程 支持使用学校设置的默认封面作为班级群的封面。

3.10 2020年08月04日

消息订阅 课节内实时推送 新增订阅项 启动录课详情。

3.9 2020年06月01日

  • 修改接口：

    • 接口 课程下添加学生/旁听（单个），课程下添加学生/旁听（多个） 支持同步用户姓名至班级昵称，详情请参考接口描述。
    • 接口 课程下添加学生（多个） 和 课节下添加学生（多个） 不再支持代注册（代注册指的是：传参的学生手机号码，如果不是ClassIn账号，支持自动注册。）；
    • 课程/课节下添加学生的相关接口（如下四个接口），将不再支持将学生自动添加为机构学生，新增错误码 228 表示“机构下无此学生”。对一个学生或者老师进行排课的标准操作为：注册 --> 添加机构学生/老师 --> 排课。涉及的接口包括：
      • 课程下添加学生/旁听（单个）: 请求参数 studentName 项由必填改为非必填。仅用于当identity为2（旁听身份）时，才使用请求参数studentName。当identity为2时，如果没有传此参的话，则使用手机号码作为旁听生的名字。当identity为1（学生身份）时，传了参数studentName也不会被使用。
      • 课程下添加学生/旁听（多个）: 请求参数 studentJson 里的 name 项由必填改为非必填。仅用于当identity为2（旁听身份）时，才使用请求参数name。当identity为2时，如果没有传此参的话，则使用手机号码作为旁听生的名字。当identity为1（学生身份）时，传了参数studentJson里的name也不会被使用。
      • 课节下添加学生（多个）: 删除了原请求参数中 studentJson 里的 name 项（传了不报错，但也不会使用）。
      • 课程下多个课节添加学生: 删除了原请求参数中 studentName 项（传了不报错，但也不会使用）。

  • 新增待废弃接口和订阅消息项（已从本文档中删除，详情请查看 Deprecation）：

    • 接口 删除课程；
    • 接口 修改用户信息，以及下线消息订阅 机构维度推送的消息 里的项目 用户修改昵称；

3.8 2020年05月08日

  • 新增接口：
    • 接口 修改群成员的班级昵称 此接口用课程下所有学生和旁听生，在机构下的学生姓名，来修改群里学生和旁听生的 班级昵称。修改后，学生在客户端的 IM 班级群里，以及该课程下的教室里上课时，显示的名字均为学生姓名，而非用户昵称。此接口解决了，学生在ClassIn客户端修改用户昵称后，老师经常在群里和教室里上课时，对不上号的问题。
  • 修改接口：
    • 接口 创建课程，编辑课程，新增课程设置项allowAddFriend，以设置是否允许班级成员相互添加好友。

3.7 2020年04月10日

3.6 2020年03月16日

新增待废弃接口：

3.5 2020年02月18日

消息订阅 课节内实时推送 新增订阅项 直播页面用户登录。

3.4 2020年02月15日

  • 修改接口：
    • 删除单个课节视频，新增参数 fileId 以支持删除课节下某一视频片段文件。详情请参考具体接口 删除单个课节视频
  • 新增待废弃接口：
    • 修改用户信息 接口将会在 2020.06.01 日后弃用，不再维护。详情请查看具体接口 修改用户信息。用户的昵称和头像，属于用户个人隐私数据，故不再支持机构对其进行修改。机构在自己的系统里，应该使用用户在机构下的 用户姓名 信息，不应该使用用户昵称信息。
    • 消息订阅 - 机构维度推送的消息 - 用户修改昵称 该消息订阅项将会在 2020.06.01 日后弃用，不再维护。详情请查看消息订阅 用户修改昵称。

3.3 2019年12月25日

消息订阅 课节结束后推送的消息 里的 课节汇总数据 新增子项“edbEnd”：教室打开 edb 课件的统计信息。

3.2 2019年12月17日

  • 修改对接域名及协议头
    • 所有接口 URL 域名调整为 https://api.eeo.cn，之前是 https://www.eeo.cn, 将在2020年06月01日将强制只支持 https://api.eeo.cn。
    • 所有接口 URL 协议头仅支持 https，当前是 http 与 https 兼容，将在2020年06月01日将强制只支持 https。

  • 修改接口：

    • 添加老师，新增 288 错误码，表示此号段不合法。详情请参考具体接口添加老师；
    • 添加学生，新增 288 错误码，表示此号段不合法。详情请参考具体接口添加学生；
    • 修改用户昵称，修改接口名称为 修改用户信息，并新增参数 Filedata，新增错误码等，支持修改用户客户端头像。详情请参考具体接口修改用户信息；
    • 创建课节（单个），开课时间修改为须在3年以内，之前是2年以内。详情请参考具体接口创建课节（单个）；
    • 创建课节（多个），开课时间修改为须在3年以内，之前是2年以内。详情请参考具体接口创建课节（多个）；
    • 获取唤醒客户端秘钥，新增支持 uid 参数，将原有 telephone 参数改为非必填，两个参数同时传入的情况下以 uid 为准。详情请参考具体接口 获取唤醒客户端秘钥；
    • 获取唤醒客户端并进入教室链接，新增支持 uid 参数，将原有 telephone 参数改为非必填，两个参数同时传入的情况下以 uid 为准。详情请参考具体接口 获取唤醒客户端并进入教室链接；
    • 课程下添加学生（多个），删除 isRegister,password参数，不再支持代注册功能。详情请参考具体接口课程下添加学生（多个）；
    • 课节下添加学生（多个），删除 isRegister,password参数，不再支持代注册功能。详情请参考具体接口课节下添加学生（多个）；

  • 新增接口：

    • 注册用户（多个），一次性最多可注册 10 个用户。详情请参考具体接口 注册用户（多个）；

  • 新增待废弃接口：

    • 删除课程 接口将会在 2020.06.01 日后弃用，不再维护。详情请查看具体接口 删除课程。

3.1 2019年11月15日

为了能够支持更换ClassIn账号手机号码（此功能还未上线，后续将支持），我们修改了所有传参手机号码的接口，以支持既可以传参手机号码，也可以uid（手机号码和uid，两者必须传一个，如果两者均传，则以uid为准，即接口不做两者一致性的检查）。

从 2020 年 06 月 01 日起，除了注册接口之外，所有原需传参手机号码的接口，将只支持传参uid。
您需要在上述截止日期之前，完成：

  • 修改您的API对接代码，支持传参uid；
  • 在您的数据库里，保存手机号码和uid之间的对应关系。

以下接口被修改以支持uid，且新增 400 错误码，表示请求数据不合法（即uid不存在或者uid不属于该机构学生或者老师）。

  • 修改用户昵称，新增 uid 参数，将原有 telephone 参数改为非必填，两个参数同时传入的情况下以 uid 为准。详情请参考具体接口 修改用户昵称；
  • 修改用户密码，新增 uid 参数，将原有 telephone 参数改为非必填，两个参数同时传入的情况下以 uid 为准。详情请参考具体接口 修改用户密码；
  • 修改用户密码（不提供原密码），新增 uid 参数，将原有 telephone 参数改为非必填，两个参数同时传入的情况下以 uid 为准。详情请参考具体接口 修改用户密码（不提供原密码）；
  • 添加学生，新增 studentUid 参数，将原有 studentAccount 参数改为非必填，两个参数同时传入的情况下以 studentUid 为准。详情请参考具体接口 添加学生；
  • 添加老师，新增 teacherUid 参数，将原有 teacherAccount 参数改为非必填，两个参数同时传入的情况下以 teacherUid 为准。详情请参考具体接口 添加老师；
  • 停用老师，新增 teacherUid 参数，将原有 teacherAccount 参数改为非必填，两个参数同时传入的情况下以 teacherUid 为准。详情请参考具体接口 停用老师；
  • 启用老师，新增 teacherUid 参数，将原有 teacherAccount 参数改为非必填，两个参数同时传入的情况下以 teacherUid 为准。详情请参考具体接口 启用老师；
  • 更新课节教师对学生评价，新增 studentUid 参数，将原有 studentAccount 参数改为非必填，两个参数同时传入的情况下以 studentUid 为准，传入 studentAccount 时接口返回 studentAccount；传入 studentUid 时接口返回 studentUid。详情请参考具体接口 更新课节教师对学生评价；
  • 创建课程，新增 mainTeacherUid 参数，将原有 mainTeacherAccount 参数改为非必填，两个参数同时传入的情况下以 mainTeacherUid 为准。详情请参考具体接口 创建课程；
  • 编辑课程，新增 mainTeacherUid 参数，将原有 mainTeacherAccount 参数改为非必填，两个参数同时传入的情况下以 mainTeacherUid 为准。详情请参考具体接口 编辑课程；
  • 创建课节（单个），新增 teacherUid、assistantUid 参数，将原有 teacherAccount 参数改为非必填。详情请参考具体接口 创建课节（单个）；
  • 创建课节（多个），新增 teacherUid、assistantUid 参数，将原有 teacherAccount 参数改为非必填。详情请参考具体接口 创建课节（多个）；
  • 修改课节信息，新增 teacherUid、assistantUid 参数，将原有 teacherAccount 参数改为非必填。详情请参考具体接口 修改课节信息；
  • 课程下添加学生/旁听（单个），新增 studentUid 参数，将原有 studentAccount 参数改为非必填，两个参数同时传入的情况下以 studentUid 为准。详情请参考具体接口 课程下添加学生/旁听（单个）；
  • 课程下删除学生/旁听（单个），新增 studentUid 参数，将原有 studentAccount 参数改为非必填，两个参数同时传入的情况下以 studentUid 为准。详情请参考具体接口 课程下删除学生/旁听（单个）；
  • 课程下添加学生/旁听（多个），新增 uid 参数，将原有 account 参数改为非必填，两个参数同时传入的情况下以 uid 为准。详情请参考具体接口 课程下添加学生/旁听（多个）；
  • 课程下删除学生/旁听（多个），新增 studentUidJson 参数，将原有 studentJson 参数改为非必填，两个参数同时传入的情况下以 studentUidJson 为准。详情请参考具体接口 课程下删除学生/旁听（多个）；
  • 课节下添加学生（多个），新增 uid 参数，将原有 account 参数改为非必填，两个参数同时传入的情况下以 uid 为准。详情请参考具体接口 课节下添加学生（多个）；
  • 课节下删除学生（多个），新增 studentUidJson 参数，将原有 studentJson 参数改为非必填，两个参数同时传入的情况下以 studentUidJson 为准。详情请参考具体接口 课节下删除学生（多个）；
  • 更换课程老师，新增 teacherUid 参数，将原有 teacherAccount 参数改为非必填，两个参数同时传入的情况下以 teacherUid 为准。详情请参考具体接口 更换课程老师；
  • 移除课程老师，新增 teacherUid 参数，将原有 teacherAccount 参数改为非必填，两个参数同时传入的情况下以 teacherUid 为准。详情请参考具体接口 移除课程老师；
  • 课程下多个课节添加学生，新增 studentUid 参数，将原有 studentAccount 参数改为非必填，两个参数同时传入的情况下以 studentUid 为准。详情请参考具体接口 课程下多个课节添加学生；

2019年10月15日

重要：为了给您提供更好的产品和服务，系统会在每个月的 20 日进行定期例行维护，每个月的具体维护时间，请访问以下链接。
https://www.eeo.cn/partner/product_book/zh-hans/function/System/Maintainance.html
请您在排课的时候，确保课节时间与系统维护时间没有重合。在系统维护期间的所有API请求，都会返回 901 的状态码。

3.1 2019年10月14日

修改接口：

  • 修改课节信息 新增开课后如未设置助教可添加助教，如开课后已设置助教不可更换和删除。详情请参考具体接口 修改课节信息；

3.0 2019年10月1日

修改接口：

  • 创建课程， 新增过期时间不传、传0、传空均当成0，课程过期时间设置为永不过期0；详情请参考具体接口 创建课程
  • 编辑课程， 新增过期时间不传或传空，不修改；传0，修改成永不过期；传非0的时间戳，则修有效期为传过来的时间；详情请参考具体接口 编辑课程
  • 添创建课节单个， 新增isHd的值支持传2，表示全高清；详情请参考具体接口 创建课节单个；
  • 创建课节多个， 新增isHd的值支持传2，表示全高清；详情请参考具体接口 创建课节多个；
  • 修改课节上台学生数， 新增isHd的值支持传2，表示全高清；详情请参考具体接口 修改课节上台学生数；

2.15 2019年09月02日

修改接口：

  • 创建课程， 修改为创建课程时不选择云盘文件夹 ID，默认为空目录。详情请参考具体接口 创建课程；

2.14 2019年08月09日

新增接口：

修改接口：

  • 删除课程，新增错误码 822 表示删除课程成功，删除唯一标识失败。详情请参考具体接口 删除课程；
  • 删除课节，新增错误码 823 表示删除课节成功，删除唯一标识失败。详情请参考具体接口 删除课节；
  • 编辑老师，新增参数 teacherUid，支持以用户 UID 编辑老师信息。详情请参考具体接口 编辑老师；
  • 注册用户，新增参数 addToSchoolMember，以支持注册完直接添加为机构老师或者学生。详情请参考具体接口 注册用户；
  • 创建课节（单个） 新增参数 classIntroduce，支持添加课节简介功能。详情请参考具体接口 创建课节（单个）；
  • 创建课节（多个） 新增参数 classIntroduce，支持添加课节简介功能。详情请参考具体接口 创建课节（多个）；
  • 修改课节信息 新增参数 classIntroduce，支持修改课节简介功能。详情请参考具体接口 修改课节信息；
  • 添加学生，原名称机构下添加学生，修改接口名称为添加学生，其内容及功能不变。详情请参考具体接口 添加学生；

2.13 2019年07月31日

  • 创建文件夹 如果云盘已存在同名文件夹，则返回 206 错误码的同时会返回之前云盘文件夹的ID。
  • 重命名文件夹 如果云盘已存在同名文件夹，则返回 206 错误码的同时会返回之前云盘文件夹的ID。

2.12 2019年07月8日

  • 新增错误码： 800 表示老师被停用中、804 表示助教被停用中、805 表示班主任被停用中，被停用中的账号需要等待系统完成停用后再启用，预计等待1-5分钟。涉及接口如下
    • 启用老师，新增 800 错误码
    • 创建课程，新增 805 错误码
    • 编辑课程，新增 805 错误码
    • 更换课程老师，新增 800 错误码
    • 创建课节（单个），新增 800、804 错误码
    • 创建课节（多个），新增 800、804 错误码
    • 修改课节信息，新增 800、804 错误码

2.11 2019年07月01日

  • 新增已废弃接口（已从本文档中删除，详情请查看 Deprecation）
    • 获取课节列表
    • 获取课程下学生/旁听
    • 获取课程信息
    • 获取课节信息
    • 获取课节直播流地址、回放视频地址
    • 获取单课节直播/回放播放器地址
    • 获取课程列表

2.10 2019年06月17日

  • 机构消息订阅中 课节内设备检测报告、用户教室外设备检测报告 中将用户 IP 保留前三位，例如：127.0.0.*。详情请参考具体接口。

2.9 2019年05月24日

  • 机构消息订阅中 课节内设备检测报告、用户教室外设备检测报告 中新增 deviceType表示用户设备信息，详情请参考具体接口。

2.8 2019年05月17日

  • 机构消息订阅中 课节内设备检测报告、用户教室外设备检测报告 中删除用户 IP，服务器名称字段。详情请参考具体接口。

2.7 2019年04月28日

  • 创建课节（单个）、创建课节（多个）、编辑课节、课节设置录课、直播、回放（多个） 接口新增返回值 课节直播播放器地址、课节直播流地址，如果在调用接口时开启录课、直播等才会返回，详情请查看具体接口。替代废弃接口 获取单课节直播/回放播放器地址、获取课节直播流地址、回放视频地址。

2.6 2019年04月08日

  • 新增待废弃接口
    • 获取课程列表 接口将会在未来版本中弃用，不再维护。

2.5 2019年04月01日

  • ClassIn 下载按钮链接 接口中从 2019年05月01号开始不再提供 WinXP 下载链接。详情请参考具体接口 ClassIn 下载按钮链接 API 说明。
  • 新增待废弃接口
    • 获取课节列表 接口将会在未来版本中弃用，不再维护。
    • 获取课程下学生/旁听 接口将会在未来版本中弃用，不再维护。
    • 获取课程信息 接口将会在未来版本中弃用，不再维护。
    • 获取课节信息 接口将会在未来版本中弃用，不再维护。
    • 获取课节直播流地址、回放视频地址 接口将会在未来版本中弃用，不再维护。
    • 获取单课节直播/回放播放器地址 接口将会在未来版本中弃用，不再维护。

2.4 2019年03月25日

  • 修改接口中涉及域名的地方，将 www.eeo.cn 修改为 root_url。用户在实际接口环境调用中需要将地址替换为真实环境地址。例如：对接 ClassIn API 的用户需要将 root_url 替换为 www.eeo.cn。
  • 获取课节直播流地址、回放视频地址 接口在返回回放视频地址时新增 Size、FileId、Duration 参数，详情请参考具体接口。

2.3 2019年01月25日

  • 针对 获取课程直播/回放播放器地址、获取课节直播/回放播放器地址 iframe 嵌套，iOS 11+ cookie 写入不进去的情况，现已修复（在 H5 引入我们的 js 文件即可），详情请参考具体接口。

2.3 2019年01月23日

  • 修改接口
    • 新增参数 courseUniqueIdentity：唯一标识，如果传入此值，则该接口会校验此唯一值是否已存在，如果已存在，则会返回之前已经创建成功的课程/课节ID，如果不存在，则接口正常执行。涉及接口 创建课程、创建课节（单个）、创建课节（多个）。
    • 新增错误码 398，表示数据已存在（唯一标识已存在）。涉及接口 创建课程、创建课节（单个）、创建课节（多个）。
    • 新增错误码 133，表示已存在（传过来的classJson中唯一标识有重复）。如果该 classJson 串中有重复的唯一值，则重复的这个课节不会创建成功。涉及接口 创建课节（多个）。

2.2.20 2019年01月02日

  • 机构消息机构订阅
    • 课节内详细数据 新增摄像头位置信息，详情请参考具体接口 课节内详细数据。

2.2.19 2018年10月22日

  • 新增废弃接口，（已从本文档删除，详情请查看 Deprecation）
    • 获取课节教师对学生的评价
    • 获取课节学生对教师的评价
    • 获取课节下出勤成员的时间信息

2.2.18 2018年09月28日

  • 新增废弃接口，（已从本文档删除，详情请查看 Deprecation）
    • 获取用户最新设备自检信息
    • 获取用户课程列表

2.2.17 2018年09月18日

  • 新增接口
    • 结束课程，课程下没有正在上的课节，即可结束课程。如果课程下有尚未开始的课节，会先删除未开始的课节之后，再结束课程。详情请参考具体接口 结束课程。
  • 修改接口
    • 创建课程、编辑课程：接口新增教室设置 ID 参数，选择此套设置后，该课程下所有教室内会依照此设置展示。接口新增错误码：371表示教室设置不存在，373表示教室设置不属于本机构。详情请参考接口 创建课程 编辑课程
    • 删除课程：接口新增错误码：393表示课程下有已结束的课节，不能删除。即，该接口之前的逻辑为：只要该课程下有正在上课的课节，就无法删除；修改后的逻辑为：该课程下有已结束的课节或者正在上课的课节，就无法删除。详情请参考接口 删除课程。

2.2.16 2018年09月06日

  • 新增废弃接口，（已从本文档中删除，详情请查看 Deprecation）
    • 获取机构标签（分页）

2.2.15 2018年09月05日

  • 新增接口
    • 移除课程老师，移除课程老师后，在 eeo.cn 课程详情中的教师列表中不再显示该老师，ClassIn 客户端的班级群中也不再显示该老师。详情请参考具体接口 移除课程老师。
    • 修改课节锁定状态，如果在 eeo.cn 后台开启了自动删除录课视频和监课图片的功能后，将课节修改为锁定状态，则该课节的录课视频和监课图片将不会被自动删除。详情请参考具体接口 修改课节锁定状态。
  • 更新接口
    • 创建课节（单个）、创建课节（多个）、修改课节信息 接口修改错误码 165 表示单节课不能少于15分钟且不能超过24小时，之前限制为至少1分钟。详情请参考具体接口。

2.2.14 2018年08月28日

  • ClassIn 下载按钮链接 新增移动端下载链接和二维码。详情请参考 ClassIn 下载按钮链接
  • 机构消息订阅
    • 课节相关消息 新增教室内老师或者助教往 eeo.cn 管理后台发送的求助信息（只包括文字信息，不包括求助时客户端的截图）。但不包括从 eeo.cn 往教室里发送的任何信息。详情请参考 课节相关消息。

2.2.13 2018年08月16日

  • 接口新增支持项： 新增支持 1v6 高清，目前高清可选 1v1 和 1v6 。所涉及接口： 创建课节（单个）、创建课节（多个）、修改课节上台学生数。

2.2.12 2018年08月10日

  • 机构消息订阅
    • 课节网络状态报告 里增加了 "系统CPU占用率" 数据。详情请查看具体接口 课节相关消息。
    • 机构相关信息 增加 "用户修改昵称" 数据，详情请参考具体接口 机构相关消息。

2.2.11 2018年08月09日

  • 新增接口
  • 修改接口
    • 创建课程，编辑课程，新增错误码 389 表示班主任已被停用。详情请参考具体接口。
    • 创建课节（单个），创建课节（多个），修改课节信息，新增错误码 387 表示老师已被停用；388 表示助教已被停用。详情请参考具体接口。
    • 更换课程老师，新增错误码 387 表示老师已被停用。详情请参考具体接口。

2.2.10 2018年08月07日

  • 新增已废弃接口（已从本文档中删除，详情请查看 Deprecation）
    • 获取学生列表
    • 获取机构老师列表
    • 获取学生评论列表
    • 获取上课中课节成员的时间
    • 获取 ClassIn 客户端下载地址

2.2.9 2018年07月12日

  • 新增接口
    • 删除单个课节视频，删除后不再产生存储费用，详情请参考具体接口 删除单个课节视频。

2.2.8 2018年07月10日

  • 接口新增支持项：学生进入教室是否自动上台，创建课节选择是否 1v1 高清。所涉及接口： 创建单课（单个）、创建单课（多个、修改课节信息、修改课节上台学生数。
  • 新增接口：

2.2.7 2018年07月02日

  • 机构消息订阅
    • 课节内详细数据 中退出教室字段新增退出教室原因，详情请参考 课节内详细数据。

2.2.6 2018年06月28日

  • 获取网页唤起客户端并进入教室链接 支持移动端（Android）网页唤起客户端，详情请参考 获取网页唤起客户端并进入教室链接。
  • 规则修改：以下规则不影响正常调用，可根据自身系统做出相应修改。
    • 机构账号也可以添加为学生/旁听，所涉及接口 课程下添加学生/旁听（单个）、课程下添加学生/旁听（多个）、课节下添加学生（多个）、课程下多个课节添加学生，详情请参考相关接口。
    • 上课中可以修改课节老师，所涉及接口 编辑课节。详情请参考 编辑课节。
    • 旁听生最多可以添加 20 个，所涉及接口 课程下添加学生/旁听（单个）、课程下添加学生/旁听（多个），详情请参考相关接口。

2.2.5 2018年06月11日

  • 新增接口：机构下添加学生，注册成功后即可调用此接口成功本机构下学生。详情请查看 机构下添加学生。
  • 注册用户 修改描述，详情请参考 注册用户。

2.2.4 2018年05月11日

  • 机构消息订阅
    • 课节内详细数据 中答题器下新增两个字段 SelectedItem 学生选择的答案，LastCommitTime 学生提交答案时间，详情请参考 课节内详细数据。
  • 获取课节下出勤成员的时间信息 接口将会在未来版本中弃用，不再维护。
  • 获取课节教师对学生的评价 接口将会在未来版本中弃用，不再维护。
  • 获取课节学生对教师的评价 接口将会在未来版本中弃用，不再维护。

2.2.3 2018年04月26日

  • 获取用户最新设备自检信息、获取用户课程列表 接口将会在未来版本中弃用，不再维护。

  • 机构消息订阅

    • 新增 用户教室外设备检测报告，实时监测机构下用户设备检测，用户点击检测设备后，会给机构推送相关数据。详情请参考 用户教室外设备检测报告。

2.2.2 2018年03月27日

  • ClassIn API SDK 正式推出！！！为了更方便您使用 ClassIn API，我们提供了 PHP 语言的 SDK。详情请咨询客户经理。

  • 机构消息订阅

    • 新增回调信息 机构相关消息，机构上传文件后可收到此消息。详情请参考 机构相关消息。
    • 课节相关消息 新增 课节网络状态报告 和 课节内设备监测报告，并将 评价消息 和 录制文件生成 合并至 课节相关消息，详情请参考 课节相关消息。

2.2.1 2018年03月20日

2.2.0 2018年03月07日

  • 新增错误码 369：表示该课程/课节类型暂不支持该操作。涉及接口：所有传递 courseId 参数的接口。例 编辑课程、创建课节(单个) 等接口。
  • 获取课节信息 接口返回参数新增 助教账号和姓名。详情请参考 获取课节信息。

2.1.11 2018年02月07日

2.1.10 2018年02月01日

  • 机构消息订阅相关接口 下 课节详细数据 接口中新增获取教室内发言数据（包含文字与图片），详情请参考 课节详细数据。
    以下更新对功能没有任何变化，仅对部分接口增加/修改描述。
  • 获取登陆客户端密钥 修改接口名称为 获取唤醒客户端密钥，详情请参考 获取唤醒客户端密钥。
  • 获取登陆客户端链接 修改接口名称为 获取唤醒客户端并进入教室链接。添加中间页描述：iOS 移动端返回的链接中已经加入了中间页，无须拼接。详情请参考 获取唤醒客户端并进入教室链接。
  • 编辑课程 声明原有规则，编辑课程时填写课程资源 ID，编辑成功后，所有未开课的课节均会修改为编辑课程成功后的课程资源，不传递课程资源 ID 则不会改变。详情请参考 编辑课程。
  • 注册用户 纠正昵称（nickName）参数描述，原有描述：默认注册手机号，最长24位字符，超过24字会自动截取为24字（昵称会显示在教室内摄像头下方）。纠正后：最长24位字符，超过24字会自动截取为24字（昵称会显示在教室内摄像头下方）；客户端显示默认为手机号。不填写昵称，登录客户端会弹出填写昵称的弹框。详情请参考 注册用户。
  • 创建课节（单个）、创建课节（多个） ，详情请参考 创建课节（单个），创建课节（多个）。
    • 录课（record）增加描述：若需要直播或者回放，则必须选择录课，否则无法无法开启直播、回放
    • 直播（live）增加描述：若需要直播，则必须开启录课
    • 回放（replay）增加描述：若需要回放，则必须开启录课
  • 参数规则 增加描述：时间戳：Unix Epoch 时间戳是 1970年1月1日 00:00:00 (世界标准时间) 起经过的秒数，凡接口中涉及到的时间戳均以此规则传输，详情请参考 参数规则。

2.1.9 2018年01月20日

2.1.8 2018年01月10日

2.1.7 2018年01月03日

  • 附录
    • 增加 ClassIn 课节相关字段的限制 介绍页面，详情请参考 参数规则概览。
    • 修改 Postman 示例包 测试文件及流程，详情请参考 Postman 示例包。
  • 所有 API 中手机号规则修改为：中国大陆手机号直接填写 11 位手机号，不支持填写国家号 0086，否则会提示手机号不合法。
  • 课程下添加学生/旁听（多个）、课节下添加学生（多个）新增错误码 288 表示此号段不合法，修改字段 isRegister 为选填项。详情请参考课程下添加学生/旁听（多个），课节下添加学生（多个）。

2.1.6 2017年12月24日

  • 增加 Deprecation 页面，此页面展示废弃接口。详情请参考Deprecation。
    • 获取学生列表、 获取机构老师列表、获取学生评论列表、获取上课中课节成员的时间、获取 ClassIn 客户端下载地址 接口将会在接下来的版本中弃用。
  • 机构订阅相关接口 下 课节详细数据 接口进教室字段加了 Device 表示登陆客户端类型，出教室字段加了 Reason 表示退出教室原因，详情请参考课节详细数据。
  • 增加 ClassIn 下载按钮链接，之前存放于 获取 ClassIn 客户端下载地址 详情请参考 ClassIn 下载按钮链接。

2.1.5 2017年12月18日

  • 增加接口 修改课节上台学生数，修改的上限值为机构最大上台人数，超出默认为机构最大上台人数，机构最大上台人数默认是 1v12，详情请参考 修改课节上台学生数。

  • 获取机构老师列表 接口新增错误码：106 表示无数据（在此之前返回 false），详情请参考 获取机构老师列表。

  • 修改课节信息 接口新增错误码 350 表示开课前20分钟内不能修改课节名称、上课时间、云盘资源、台上人数。详情请参考 修改课节信息。

  • 教室内数据相关接口 修改名称为 机构订阅相关接口，机构消息订阅 修改名称为 消息订阅说明，只对名称做修改，内容不变，详情请参考 机构订阅相关接口，消息订阅说明。

2.1.4 2017年12月13日

2.1.3 2017年12月4日

  • 删除修改机构学生手机号。
  • 将修改用户基本信息接口名称修改为修改用户昵称，接口原有功能不变，详情请参考 修改用户昵称。

2.1.2 2017年12月1日

  • 获取登录客户端链接新增加 deviceType （平台标志）参数，1代表 PC，2代表 iOS，3代表 Android。默认为 1，详情请参考 获取登陆客户端连接。

2.1.1：2017年11月27日

2.1.0：2017年11月14日

  • 注册用户：新增加上传用户头像的参数，Filedata，详细请参考用户相关接口下 注册用户 接口。
  • 获取登录客户端密钥：去掉返回链接中 identity 参数。详情请参考 获取登陆客户端密钥。
  • 注册用户：ClassIn 2.0 后支持国际手机号注册，格式为 00国家号-手机号。中国大陆手机号可以省略国家号，注：所有关于手机号的参数都支持国际手机号格式。 详情请参考相关接口。
  • 获取学生列表：返回参数总添加参数 studentUid，详情请参考 获取学生列表 接口。

2.0.0：2017年10月30日

  • EEO 基础 API 新增：获取课节教师对学生的评价、获取课节学生对教师的评价，详情请参考获取课节教师对学生的评价、获取课节学生对教师的评价。
  • 创建课程：增加了两个参数 mainTeacherAccount、courseIntroduce，详细请参考创建课程。
  • 编辑课程：增加了四个参数 mainTeacherAccount、stamp、Filedata、courseIntroduce，详细请参考 编辑课程。
  • 创建课节（单个）：增加了一个参数 assistantAccount，详情请参考 创建课节（单个）。
  • 创建课节（多个）：增加了一个参数 assistantAccount，详情请参考 创建课节（多个）。
  • 修改课节信息：增加了一个参数 assistantAccount，详情请参考 修改课节信息。
  • 创建课节(多个)、课节设置录课、直播、回放(多个)、课节下添加学生(多个)、课程下添加学生/旁听(多个)，增加批量接口自定义标识字段customColumn，详情请参考具体接口。
  • 获取直播、回放播放器地址：用户从机构的应用进入直播 Web 页面，免登录就可以聊天和点赞，详情请参考 获取直播、回放播放器地址。
  • 修改了一些字段的长度限制，详情请参考具体接口。

1.8.0：2017年8月14日

  • 增加教室内数据推送服务：机构提供数据接收地址，以接收 EEO Hamster 服务器实时发送的数据。接口文档请参考 教室内数据相关接口。

1.7.0：2017年6月10日

1.6.0：2017年5月10日

  • EEO 基础 API 获取用户课程列表接口返回参数 class_list 对象增加了 released 返回值。详情请参考 获取课程列表。

1.5.0：2017年5月8日

  • EEO 基础 API 部分参数描述改动，请尽量使用最新文档。web 页 API 文档更新完成。

1.4.0：2017年4月24日

1.3.0：2017年4月18日

  • 更正 EEO 基础 API 文档部分接口的返回值与实际返回值不一致的情况，请尽量下载阅读最新文档。

1.2.0：2017年3月30日

1.1.0：2017年3月28日

1.0.0：2017年3月23日

  • 获取课节列表（getCourseClass）接口，返回值新增"class_btime": "课节开始时间戳","class_etime": "课节结束时间戳"，详情请参考获取课节列表。

  • 获取课节信息（getClassInfo）接口，返回值新增"class_btime": "课节开始时间戳","class_etime": "课节结束时间戳"，详情请参考获取课节信息。

results matching ""

    No results matching ""