结束课程
结束课程,需要提供 SID,safekey,timeStamp,课程 ID,返回执行后的说明。注意:课程下没有正在上的课节,即可结束课程。如果课程下有尚未开始的课节,会删除未开始的课节之后结束课程,请谨慎使用此功能
URL
https://root_url/partner/api/course.api.php?action=endCourse
HTTP Request Methods
编码格式
请求参数
key |
必填 |
更多限制 |
说明 |
规则说明 |
SID |
是 |
无 |
机构认证 ID |
通过 eeo.cn 申请机构认证可获得 |
safeKey |
是 |
固定 32 位全小写字符 |
机构认证安全密钥 |
safeKey=MD5(SECRET+timeStamp) |
timeStamp |
是 |
无 |
当前调用接口20分钟以内的 Unix Epoch 时间戳 |
Unix Epoch 时间戳是 1970年1月1日 00:00:00 (世界标准时间) 起经过的秒数 |
courseId |
是 |
无 |
课程 ID |
无 |
响应参数
key |
类型 |
示例值 |
含义 |
error_info |
object |
|
返回信息对象 |
└ errno |
number |
1 |
错误代码 |
└ error |
string |
"程序正常执行" |
错误详情 |
示例
POST /partner/api/course.api.php?action=endCourse HTTP/1.1
www.eeo.cn
application/x-www-form-urlencoded
no-cache
SID=1002289&safeKey=9c5cceb65abc66f7d5f5ac5ff212a1ba&timeStamp=1492925596&courseId=1418
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
-d "SID=1234567" \
-d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
-d "timeStamp=1484719085" \
-d "courseId=352855" \
"https://root_url/partner/api/course.api.php?action=endCourse"
响应示例(正常时返回的 json
数据包示例)
{
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
错误码说明
错误码 |
说明 |
1 |
表示成功执行 |
100 |
表示参数不全或错误 |
102 |
表示无权限(安全验证没通过) |
104 |
表示操作失败(未知错误) |
114 |
表示服务器异常 |
144 |
表示机构下无此课程 |
147 |
表示无此课程信息 |
149 |
表示该课程已删除 |
153 |
表示课程已过期 |
369 |
该课程/课节类型暂不支持该操作 |
394 |
表示课程下有正在上的课节,不能结束 |