Để tạo thư mục cần truyền các tham số SID, safekey, timeStamp, ID thư mục gốc (thư mục được tạo sẽ thuộc thư mục nào) và tên thư mục
Lưu ý: Tổng số thư mục con tối đa trong một thư mục được giới hạn ở 5.000 và tối đa là 15 cấp thư mục. Nếu vượt quá sẽ nhận báo lỗi, quá trình tạo mới thư mục không thành công. Hãy chú ý đến kích thước thư mục, cũng như xóa các thư mục, tập tin không cần thiết.
Create folders,You need to provide SID, safekey, timeStamp, parent folder ID (under which folder you create folders), folder name. Returns the folder ID after success,Error description returned after failure.
Note: The maximum number of directories in a folder is 5000 and the maximum depth is 15 levels. If the number exceeds this, an error will be reported and the creation will fail. Please pay attention to the folder size and delete unnecessary folders and files.
URL #
https://api.eeo.cn/partner/api/cloud.api.php?action=createFolder
HTTP Request Methods #
- POST
Coding format #
- UTF-8
Request data #
Key | Bắt buộc | Yêu cầu thêm | Mô tả | Hướng dẫn |
---|---|---|---|---|
SID | Bắt buộc | — | ID của trường | Xem dữ liệu này tại Trang quản lý classin.com trong mục API |
safeKey | Bắt buộc | Fixed 32-bit all lowercase characters | Khóa bảo mật xác thực trường học | safeKey=MD5(SECRET+timeStamp) |
timeStamp | Bắt buộc | — | Theo Unix Epoch timestamp & có hiệu lực trong vòng 20 phút | 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 |
folderId | Bắt buộc | — | ID thư mục | Thư mục được tạo sẽ thuộc thư mục nào |
folderName | Bắt buộc | — | Tên thư mục | — |
Response data #
Key | Định dạng | Phản hồi | Ý nghĩa |
---|---|---|---|
data | string | 123456 | ID thư mục vừa được tạo |
error_info | object | Return message object | |
└ errno | number | 1 | Mã lỗi |
└ error | string | “Normal execution” | Chi tiết lỗi |
Sample #
- HTTP request
POST /partner/api/cloud.api.php?action=createFolder HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=10a6f11c7e2194146c88650439aa0f2e&timeStamp=1493792469&folderId=747759&folderName=tools
- Shell cURL analog request instruction
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
-d "SID=1234567" \
-d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
-d "timeStamp=1484719085" \
-d "folderId=123456" \
-d "folderName=课程1" \
"https://api.eeo.cn/partner/api/cloud.api.php?action=createFolder"
Response sample(The normal return json
packet example) #
{
"data": "123456",
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
Error Code Description #
Error Code | Description |
---|---|
1 | Thành công |
100 | Parameters sai định dạng hoặc không hoàn chỉnh |
102 | Không có quyền thao tác (Xác thực bảo mật thất bại) |
104 | Thao tác thất bại |
193 | Thư mục không tồn tại |
194 | Thư mục không thuộc trường (Không có quyền thao tác) |
196 | Thư mục không hỗ trợ thao tác |
206 | Đã có thư mục khác trùng tên tồn tại (ID thư mục sẽ được gửi kèm với báo lỗi) |
207 | Phân cấp thư mục đã vượt quá giới hạn |
208 | Số lượng thư mục đã vượt quá giới hạn |