创建课程

创建课程，需要提供 SID，safekey，timeStamp，课程名称，可用文件夹 ID，课程封面图片(二进制流)，过期时间，班主任账号，课程简介，教室设置 ID（主要用来设置教室皮肤等其他选项），唯一标识，班主任 UID，allowAddFriend，allowStudentModifyNickname；其中SID、safeKey、timeStamp、课程名称是必填项。返回的是课程 ID 及执行后的说明。
机构传入唯一标识后，该接口会校验已创建课程中是否有此唯一标识，如果有，则返回之前创建成功的课程 ID。如果没有，则正常执行。

每创建一个标准课程时，系统会自动创建一个班级群（可以在 ClassIn IM 查看此群）。创建班级群时，系统默认地使用 用户昵称 来设置群成员的名字，我们称之为 班级昵称。
如果您希望把用户姓名同步至班级昵称的话，可以在创建好课程，以及添加好课程学生/旁听生后，再调用接口 修改群成员的班级昵称 来修改课程下所有学生和旁听生的 班级昵称。

备注：

1. 可以对课程设置班主任。课程的班主任能够在（PC&Android&iOS）客户端进行管理班级（例如：创建/编辑/删除课节及学生、以及结束课程等）。请注意：班主任在客户端的操作行为，其数据不会返回至您的对接系统里（例如，班主任通过客户端创建的课节，该课节信息不回同步至您的系统里）。
2. 当传参mainTeacherUid为空时（即""），等效于不传，表示不设置课程班主任。

URL

https://root_url/partner/api/course.api.php?action=addCourse

HTTP Request Methods

• POST

编码格式

• UTF-8

请求参数

响应参数

示例

• HTTP 请求

POST /partner/api/course.api.php?action=addCourse HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=f834fff59eb3bc8a2ff26a3cb59155f0&timeStamp=1492792399&courseName=Good+Day&folderId=22419&Filedata=@~/photo.jpg&expiryTime=1492795000&mainTeacherUid=1001001&courseIntroduce=ClassIn，真正专业的在线教室&classroomSettingId=235&courseUniqueIdentity=532512

• Shell cURL模拟请求指令

curl -X "POST" \
     -d "SID=1234567" \
     -d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
     -d "timeStamp=1484719085" \
     -d "courseName=Good Day" \
     -d "folderId=22419" \
     -d "Filedata=@~/photo.jpg" \
     -d "expiryTime=1523428688" \
     -d "mainTeacherUid=1001001" \
     -d "courseIntroduce=ClassIn，真正专业的在线教室" \
     -d "classroomSettingId=235" \
     -d "courseUniqueIdentity=24545" \
     -d "allowAddFriend=1" \
     -d "allowStudentModifyNickname=0" \
     "https://root_url/partner/api/course.api.php?action=addCourse"

响应示例（正常时返回的 json 数据包示例）

{
  "data": 352861,
  "error_info": {
    "errno": 1,
    "error": "程序正常执行"
  }
}

错误码说明