Tạo hoạt động học tập LMS (Create Activity)

Mục lục

Note

  • Sử dụng API này để tạo nháp tất cả các hoạt động LMS (trừ Buổi học – Lesson):
    Bài tập;Bài kiểm tra; Video học liệu;Học liệu;Thảo luận;Phiếu đáp án; Check-in;

Note

  • You can create drafts for LMS activities (except for Classroom):
    Assignment;Test; Recorded Lesson; Resources; Discussion; Answer Sheet; Recurring Assignment;

URL

https://api.eeo.cn/lms/activity/createActivityNoClass

HTTP Request Methods

  • POST

Encoding Format

  • UTF-8

Request Data

Header

KeyBắt buộcĐịnh dạngMô tả
X-EEO-SIGNBắt buộcstringSignature; tham khảo cách tạo tại đây
X-EEO-UIDBắt buộcstringSID (Xem dữ liệu này tại Trang quản lý classin.com trong mục API)
X-EEO-TSBắt buộcstringTimestamp (Thời gian UNIX Epoch là số giây đã trôi qua kể từ 00:00:00 (giờ chuẩn quốc tế) vào ngày 1 tháng 1 năm 1970)

Body

KeyBắt buộcĐịnh dạngMô tảHướng dẫn
courseIdBắt buộcintegerID của Lớp họcTương đương với 1 Class hiển thị trên App ClassIn còn định nghĩa trong doc API là Course
unitIdBắt buộcintegerID Chương 
activityTypeBắt buộcintegerLoại2=Bài tập (Assignment);3=Bài kiểm tra (Test);4=Video học liệu (Recorded Lesson);5=Học liệu (Resources);6= Thảo luận (Discussion);7=Phiếu đáp án (Answer Sheet);8=Check-in (Recurring Assignment)
nameBắt buộcStringTên hoạt độngTối đa 50 ký tự
teacherUidBắt buộcintegerteacher ID 
startTimeKhông bắt buộcintegerStart time of the activityTheo chuẩn thời gian UNIX Epoch (trong vòng 3 năm tính từ thời điểm hiện tại)
endTimeKhông bắt buộcintegerEnd time of the activityTheo chuẩn thời gian UNIX Epoch

Response Data

KeyĐịnh dạngPhản hồiMô tả
codeinteger1Mã lỗi
msgstring Nội dung
dataarray[]returned data
 └object object
  └ nameinteger“it’s a draft”Tên hoạt động
  └ activityIdinteger26019953Activity ID

Sample

  • HTTP request
POST /lms/activity/createActivityNoClass HTTP/1.1
Host: root_url
X-EEO-SIGN: 37471286c6cfb95c4afb899396b884e2
X-EEO-UID: 409864
X-EEO-TS: 1722937773
Content-Type: application/json
Content-Length: 165

{
    "courseId": 414193,
    "unitId":22360790,
    "activityType":2,
    "name": "draft for test",
    "teacherUid":1006368, 
    "startTime":1724134581,
    "endTime":1724138181
}
  • Shell cURL analog request instruction
curl -X POST \
     -H 'Host: root_url' \
     -H 'X-EEO-SIGN: 37471286c6cfb95c4afb899396b884e2' \
     -H 'X-EEO-UID: 409864' \
     -H 'X-EEO-TS: 1722937773' \
     -H 'Content-Type: application/json' \
     -d '{"courseId": 414193,  "unitId":22360790,"activityType":2, "name": "draft of test", "teacherUid":1006368, "startTime":1724134581,"endTime":1724138181}' \
     'https://root_url/lms/activity/createActivityNoClass'

Response Sample(The normal return json json packet example)

{
    "code": 1,
    "msg": "Execution successful",
    "data": {
        "name": "draft of test",
        "unitId": 26020895
    }
}

Error Code Descriptions

Mã lỗiMô tả
147Không có thông tin lớp học này
40020Chương không tồn tại
40031Số lượng hoạt động trong Chương đã đạt giới hạn
21601030Thiếu tham số bắt buộc
101001001Lỗi tham số
101002005Lỗi Signature
101002006Timestamp hết hạn
101002008Timestamp không tồn tại
121601020Lỗi tham số
121601021Lớp học này không nằm trong trường của bạn
121601022Lớp học này không phải lớp học tiêu chuẩn
121601023Lớp học này đã kết thúc và không thể thao tác được