Chỉnh sửa thông tin Chương (Update Unit)

Mục lục

English below

Lưu ý:

  • Hỗ trợ sửa đổi tên của một hoặc nhiều Chương, phần giới thiệu và trạng thái của Chương. Nếu name, content, or publishFlag không được truyền, hệ thống sẽ trả về Incomplete or Invalid Parameters
  • Khi chỉnh sửa một Chương, tên không thể trùng với tên của Chương hiện có.
  • Khi bạn sử dụng API này để đăng một Chương (chuyển trạng thái từ nháp), các hoạt động trong chương đó sẽ không được đăng cùng lúc; nếu bạn cần đăng tải một hoạt động, vui lòng gọi API LMS tạo và đăng tải hoạt động học tập.

Note:

  • You can modify one or more of the following items: unit name, description, or publication status. If none of name, content, or publishFlag are provided, an error Incomplete or Invalid Parameters will be returned.
  • When editing a unit, the name must be unique and not duplicate any existing units in the course.
  • Publishing a unit using this interface will not automatically publish the activities within that unit. To publish those activities, please call the Release Activity Interface.

URL

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

HTTP Request Methods

  • POST

coding Format

  • UTF-8

Request Data

Header Parameters

Key Bắt buộc Định dạng Mô tả
X-EEO-SIGN Bắt buộc string Signature; tham khảo cách tạo tại đây
X-EEO-UID Bắt buộc string SID (Xem dữ liệu này tại Trang quản lý classin.com trong mục API)
X-EEO-TS Bắt buộc string Timestamp (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

key Bắt buộc Định dạng Mô tả Hướng dẫn
courseId Bắt buộc integer ID của Lớp học Tương đương với 1 Class hiển thị trên App ClassIn còn định nghĩa trong doc API là Course
unitId Bắt buộc integer Unit ID  
name Không bắt buộc string Unit Name Tối đa 50 ký tự. Lưu ý: Không được đặt tên các Chương trùng với nhau
content Không bắt buộc string Unit Description Để trống hệ thống sẽ hiểu là không có điều chỉnh
publishFlag Không bắt buộc integer Publication Status

0 = Nháp, 2 = Đã đăng (Tất cả thành viên trong lớp đều thấy Chương)

API này chỉ hỗ trợ thay đổi trạng thái từ Nháp thành Đã đăng, không hỗ trợ chuyển ngược lại

Response Data

Tham số Định dạng Phản hồi Mô tả
code integer 1 Mã lỗi
msg string “Execution successful” Nội dung
data array [] Response array
　└ object   Response object
　　└ unitId integer 26020895 ID của Chương

Sample

  • HTTP request
POST /lms/unit/update HTTP/1.1
Host: root_url
X-EEO-SIGN: a77fcc847b3704afde607bbd0c5231f4
X-EEO-UID: 409864
X-EEO-TS: 1722937832
Content-Type: application/json
Content-Length: 197

{
    "courseId": 414193,
    "unitId": 26020895,
    "name": "Edit Unit",
    "content": "Edit Unit Description",
    "publishFlag": 2
}
  • Shell cURL analog request instruction
curl -X POST \
     -H 'Host: root_url' \
     -H 'X-EEO-SIGN: a77fcc847b3704afde607bbd0c5231f4' \
     -H 'X-EEO-UID: 409864' \
     -H 'X-EEO-TS: 1722937832' \
     -H 'Content-Type: application/json' \
     -d '{"courseId": 414193, "unitId": 26020895, "name": "Edit Unit", "content": "Edit Unit Description", "publishFlag": 2}' \
     'https://root_url/lms/unit/update'

Response Sample（The normal return json packet example）

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

Error Code Descriptions

Mã lỗi Mô tả
147 Không có thông tin lớp học này
40004 Không thể chuyển Chương đã đăng trở lại về trạng thái Nháp
40020 Chương không tồn tại
50003 Trùng tên chương
101001001 Lỗi tham số
101002005 Signature không chính xác
101002006 Timestamp hết hạn
101002008 Timestamp không tồn tại
121601020 Lỗi tham số
121601021 Lớp học này không nằm trong trường của bạn
121601022 Lớp học này không phải lớp học tiêu chuẩn
121601023 Lớp học này đã kết thúc và không thể thao tác được
121601030 Thiếu tham số bắt buộc