Create folders

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,most is 15 levels.


HTTP Request Methods

  • POST

Coding format

  • UTF-8

Request data

key Required More Restrictions Instructions Description
SID Yes Null School ID It is available through the 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 Yes Null folders ID Under which folder create folders
folderName Yes Null Folder name Null

Response data

key Type Sample value meaning
data string 123456 Create the resulting folder ID
error_info object Return message object
└ errno number 1 Error code
└ error string "Normal execution" Error list


  • HTTP request
POST /partner/api/cloud.api.php?action=createFolder HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

  • 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" \

Response sample(The normal return json packet example)

  "data": "123456",
  "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).
104 Operation failed (unknown error).
193 The folder does not exist.
194 The folder does not belong to the institution(Unauthorized operation).
196 The folder does not support to operate.
206 A folder with the same name already exists (Folder ID will be returned).
207 Folder hierarchy exceeded limit.
208 The number of folders exceeds the limit.

results matching ""

    No results matching ""