Tạo và đăng tải Chương

Mục lục

English below

Note:

  • Khi tạo Chương, không hỗ trợ tạo một Chương có tên trùng lặp. Nếu tạo một Chương có tên giống nhau trong chương trình học, hệ thống sẽ báo lỗi Unit already exists  dù cho đơn vị đó có ở trạng thái bản nháp hay không.

Note:

  • When creating a unit, duplicate names are not allowed. If there is already a unit with the same name under the course, regardless of whether it is in draft status, an error will be reported as Unit already exists.

URL

https://api.eeo.cn/lms/unit/create

HTTP Request Methods #

  • POST

coding Format #

  • UTF-8

Request Data #

Header Parameters #

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 Parameters #

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 
nameBắt buộcStringTên của ChươngĐộ dài tối đa 50 ký tự. Lưu ý: Không được đặt tên các Chương trùng với nhau
publishFlagBắt buộcIntegerTrạng thái của Chương0 = Nháp, 2 = Đã đăng (Tất cả thành viên trong lớp đều thấy Chương)
contentKhông bắt buộcStringGiới thiệu ChươngMặc định trống khi không truyền dữ liệu gì

Response Data #

Tham sốĐịnh dạngPhản hồiMô tả
codeinteger1Mã lỗi
msgstring“Execution successful”Nội dung
dataarray[]Reponse array
　└object Reponse object
　　└ nameintegerCreate UnitTên Chương
　　└ unitIdinteger26019953ID của Chương

Example #

  • HTTP Request
POST /lms/unit/create 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,
    "name": "Create Unit",
    "content": "Unit Description",
    "publishFlag": 2
}
  • 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, "name": "Create Unit", "content": "Unit Description", "publishFlag": 2}' \
     'https://root_url/lms/unit/create'

Response sample（The normal return json packet example） #

{
    "code": 1,
    "msg": "Execution successful",
    "data": {
        "name": "Create Unit",
        "unitId": 26020895
    }
}

Error Code Descriptions #

Mã lỗiMô tả
147Không có thông tin về Lớp học này
29200Tạo Chương thất bại
29208Chương đã tồn tại
29213Tạo Chương thành công
40031Vượt quá số lượng Chương tối đa của lớp (1 lớp được tạo tối đa 100 Chương)
101001001Lỗi tham số
101002005Signature không chính xác
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