Gets a list of files and folders under the specified folder
Gets a list of files and folders under the specified folder,You need SID, safekey, timeStamp, and you specify the folder ID (you don't specify the folder ID, you choose the top-level folder).Returns the folders and files under the specified folder.
URL
https://api.eeo.cn/partner/api/cloud.api.php?action=getCloudList
HTTP Request Methods
Request data
key |
Required |
More Restrictions |
Instructions |
Description |
SID |
Yes |
Null |
School ID |
It is available through the eeo.cn application |
safeKey |
Yes |
Fixed 32-bit all lowercase characters |
School authentication security key |
safeKey=MD5(SECRET+timeStamp) |
timeStamp |
Yes |
Null |
imestamp used by safeKey |
Unix Epoch timeStamp is the number of seconds passed by 00:00 (world standard time) on January 1, 1970 |
folderId |
No |
Null |
folder ID |
It could be empty, return the folder and file list under the top-level folder for empty |
Response data
key |
Type |
Sample value |
meaning |
folder_list |
array |
|
Returns a list of folder lists |
└ folder 1 Information object |
object |
|
Returns a number of folder 1 objects, including the following fields |
└ folder_id |
string |
123456 |
folder ID |
└ folder_name |
string |
Cloud driver |
folder name |
└ is_system_folder |
number |
1 |
Is it a system folder,0 No,1 Yes |
└ folder 2 Information object |
object |
|
Returns a number of folder 2 objects, including the following fields |
└ folder_id |
string |
123457 |
folder ID |
└ folder_name |
string |
My teaching material |
Folder name |
└ is_system_folder |
number |
1 |
Is it a system folder,0 No,1 Yes |
└ ······ |
object |
|
Returns the number of folder objects, including the following fields |
└ folder_id |
string |
··· |
Folder ID |
└ folder_name |
string |
··· |
Folder name |
└ is_system_folder |
number |
··· |
YesIs it a system folder,0 No,1 Yes |
file_list |
array |
|
Returns an array of file lists |
└ File 1 information object |
object |
|
Returns a number of file 1 objects, including the following fields |
└ id |
string |
1234568 |
Folder ID |
└ file_name |
string |
Cloud driver |
Folder name |
└ file_size |
string |
10KB |
Folder size |
└ File 2 information object |
object |
|
Returns a number of file 2 objects, including the following fields |
└ id |
string |
1234578 |
File ID |
└ file_name |
string |
My teaching material |
The file name |
└ file_size |
string |
10KB |
The file size |
└ ······ |
object |
|
Returns the number of file objects, including the following fields |
└ id |
string |
··· |
file ID |
└ file_name |
string |
··· |
The file name |
└ file_size |
string |
··· |
The file size |
error_info |
object |
|
Return message object |
└ errno |
number |
1 |
Error code |
└ error |
string |
"Normal execution" |
Error list |
Sample
POST /partner/api/cloud.api.php?action=getCloudList HTTP/1.1
www.eeo.cn
application/x-www-form-urlencoded
no-cache
SID=2339736&safeKey=209f418afc25710c51327f3e97966a89&timeStamp=1494231322&folderId=123456
- 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" \
"https://api.eeo.cn/partner/api/cloud.api.php?action=getCloudList"
Response sample(The normal return json
packet example)
{
"folder_list": [
{
"folder_id": "714013",
"folder_name": "机构网盘",
"is_system_folder": 1
},
{
"folder_id": "713961",
"folder_name": "我的教材",
"is_system_folder": 1
},
{
"folder_id": "748651",
"folder_name": "helloworld",
"is_system_folder": 0
}
],
"file_list": [
{
"id": "496225",
"file_name": "test.php",
"file_size": "7KB"
},
{
"id": "496229",
"file_name": "test.png",
"file_size": "27KB"
}
],
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
Error Code Description
Error Code |
Description |
1 |
Successful execution. |
100 |
Incomplete or incorrect parameters. |
102 |
No permissions(Security verification failed). |
193 |
The folder does not exist. |
194 |
The folder does not belong to the institution(Unauthorized operation). |