Upload file
<h5>Interface introduction</h5>
<p>To upload a file, you need to provide SID, sign, timestamp, parent folder ID (Note: if it is empty, it means that the file is uploaded under the root directory of the institution icloud), and the file to be uploaded. The uploaded file ID is returned after success, and the corresponding error description is returned after failure。</p>
<h5>Request information</h5>
<table>
<thead>
<tr>
<th style="text-align: left;"></th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">URL</td>
<td style="text-align: left;"><a href="https://neukol.axzt.net/edu_openapi/netdisk/upload">https://neukol.axzt.net/edu_openapi/netdisk/upload</a></td>
</tr>
<tr>
<td style="text-align: left;">HTTP Request Methods</td>
<td style="text-align: left;">POST</td>
</tr>
<tr>
<td style="text-align: left;">Coding format</td>
<td style="text-align: left;">UTF-8</td>
</tr>
</tbody>
</table>
<h5>Request header</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">Field name</th>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Required</th>
<th>Description</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">no</td>
<td style="text-align: left;">no</td>
<td style="text-align: left;">no</td>
<td>no</td>
<td>no</td>
</tr>
</tbody>
</table>
<h5>Form parameter</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">Field name</th>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Required</th>
<th>Description</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">long</td>
<td style="text-align: left;">True</td>
<td>Timestamp, the timestamp within 20 minutes of the sending request time</td>
<td>1605758223230</td>
</tr>
<tr>
<td style="text-align: left;">sid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">True</td>
<td>The unique identifier of the institution is available on the first page of API description</td>
<td>5f1140092302bd0ac2dbc7c4</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">True</td>
<td>Fixed 32-bit all lowercase characters, institution authentication security key，sign=MD5(params+SECRET)，Among them, params represents the concatenated string of all parameters in the request body except sign in lexicographic order（like: “key1=value1key2=value2”）</td>
</tr>
<tr>
<td style="text-align: left;">folderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">False</td>
<td>Parent folder ID. if it is not filled in, it means that it is uploaded under the root directory. Otherwise, it must be specified and not empty</td>
<td>5fb4b9911debac4ab01ff125</td>
</tr>
<tr>
<td style="text-align: left;">fileData</td>
<td style="text-align: left;">MultipartFile</td>
<td style="text-align: left;">True</td>
<td>Upload file</td>
<td>Upload file.pdf</td>
</tr>
<tr>
<td style="text-align: left;">schoolUploaderId</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">False</td>
<td>Uploader ID</td>
<td>Upload file.pdf</td>
</tr>
<tr>
<td style="text-align: left;">schoolUploaderName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">False</td>
<td>Uploader Name</td>
<td>Upload file.pdf</td>
</tr>
</tbody>
</table>
<h5>Response parameter</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">Field name</th>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Required</th>
<th>Description</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">responseHeader</td>
<td style="text-align: left;">Object</td>
<td style="text-align: left;"></td>
<td>Response header information</td>
</tr>
<tr>
<td style="text-align: left;"> └status</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">True</td>
<td>HTTP response status code</td>
<td>200</td>
</tr>
<tr>
<td style="text-align: left;"> └msg</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">True</td>
<td>Return information</td>
<td>OK</td>
</tr>
<tr>
<td style="text-align: left;">response</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">False</td>
<td>The ID of the uploaded file. If there is an error, this field will not be returned</td>
<td>5fb672ad1debac056cc73d60</td>
</tr>
</tbody>
</table>
<h5>Request example</h5>
<pre><code>POST /edu_openapi/netdisk/upload HTTP/1.1
Host: https://neukol.axzt.net
Content-Type: application/x-www-form-urlencoded
timestamp=1605791409292&sid=5f1140092302bd0ac2dbc7c4&sign=2c9d170a7b9c697787ab26bff4f59b27&fileData="Upload file.pdf"
</code></pre>
<h5>Response example</h5>
<pre><code>{
"responseHeader": {
"status": 200,
"msg": "OK"
},
"response": "5fb672ad1debac056cc73d60"
}
</code></pre>
<h5>Error code</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">Code value</th>
<th style="text-align: left;">Explanation</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">Upload file succeeded</td>
</tr>
<tr>
<td style="text-align: left;">2103</td>
<td style="text-align: left;">The uploaded file cannot be empty</td>
</tr>
<tr>
<td style="text-align: left;">700</td>
<td style="text-align: left;">Unsupported file format</td>
</tr>
<tr>
<td style="text-align: left;">705</td>
<td style="text-align: left;">Upload file overrun (files within 100m are supported)</td>
</tr>
<tr>
<td style="text-align: left;">706</td>
<td style="text-align: left;">Cloud disk capacity has been used up</td>
</tr>
<tr>
<td style="text-align: left;">724</td>
<td style="text-align: left;">Upload folder does not exist</td>
</tr>
<tr>
<td style="text-align: left;">725</td>
<td style="text-align: left;">The name of uploaded file is not standardized</td>
</tr>
<tr>
<td style="text-align: left;">9994</td>
<td style="text-align: left;">Parameter format error</td>
</tr>
<tr>
<td style="text-align: left;">2000</td>
<td style="text-align: left;">sign certification failed</td>
</tr>
<tr>
<td style="text-align: left;">2001</td>
<td style="text-align: left;">Request timeout</td>
</tr>
<tr>
<td style="text-align: left;">2002</td>
<td style="text-align: left;">Institution does not open an open interface</td>
</tr>
<tr>
<td style="text-align: left;">2010</td>
<td style="text-align: left;">Institution is inexistent</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td style="text-align: left;">unknown exception on the server</td>
</tr>
</tbody>
</table>
<p>c</p>