Để tải tệp lên cần truyền các tham số SID, safekey, timeStamp, ID thư mục và tệp cần tải lên.
Upload file,Need SID, safekey, timeStamp, folder ID, uploaded file (binary stream mode). Returns the file ID obtained after uploading.
URL #
https://api.eeo.cn/partner/api/cloud.api.php?action=uploadFile
HTTP Request Methods #
- POST
Coding format #
- UTF-8
Request parameters #
Key | Bắt buộc | Yêu cầu thêm | Mô tả | Hướng dẫn |
---|---|---|---|---|
SID | Bắt buộc | — | ID trường | It is available through the eeo.cn application |
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 của thư mục | — |
Filedata | Bắt buộc | Binary stream | Tệp tin cần đăng tải | Được tải lên tệp có dung lượng tối đa 500MB |
Response data #
Key | Định dạng | Phản hồi | Ý nghĩa |
---|---|---|---|
data | string | 123456 | ID của tệp tin vừa tải lên |
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=uploadFile HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=479aeb917dfb34ff1bf6660a1a5f016c&timeStamp=1493798334&Filedata=@~/file.txt
- Shell cURL analog request instruction
curl -F "SID=1234567" \
-F "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
-F "timeStamp=1484719085" \
-F "folderId=123456" \
-F "Filedata=@~/file.txt" \
"https://api.eeo.cn/partner/api/cloud.api.php?action=uploadFile"
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) |
195 | Vui lòng thêm tệp tin cần đăng tải |
196 | Thư mục không cho phép thao tác |
197 | Đăng tải thất bại |
211 | Tệp tin vượt quá dung lượng tối đa |
31000 | Dung lượng của Trường đã đầy, vui lòng xóa bớt tệp tin đang có hoặc mua thêm dung lượng lưu trữ |