Wiki source code of file_storage/get_overview.php

Last modified by YellowFox_RD on 2024/12/19 10:11

Show last authors
1 (% class="box" %)
2 (((Table of Contents)))
3 {{toc/}}
4
5 Get the current directory structure of file storage including the files and their uuids to reference them for [[modifiy_file.php>>doc:YellowFox Remote Tracking Interface.Funktionen.Dateiablage.file_storagemodify_file\.php.WebHome]] or attach them via [[do_order>>doc:YellowFox Remote Tracking Interface.Funktionen.Aufträge und Nachrichten.do_order\.php.WebHome]] resp. [[do_message>>doc:YellowFox Remote Tracking Interface.Funktionen.Aufträge und Nachrichten.do_message\.php.WebHome]]. Furthermore you will get the current usage.
6 = Description =
7 **(% class="green mark" %)GET(%%)   **//**/file_storage/get_overview.php?company**=RTI_COMPANYKEY**&import**=RTI_IMPORTKEY//
8 = Parameters =
9 |=parameter|=description|=type|=hint|=mandatory
10 |company|RTI company key|string||yes
11 |import|RTI import key|string||yes
12
13 = Return =
14 Return value is a JSON. On missing parameters you will receive "(% class="error" %)**ERROR:description**(%%)".
15
16 **return example**
17 **return json**
18 {{code language="java"}}{
19 "total_space": ?,
20 "used_space": ?,
21 "structure": {
22 "name": "my storage",
23 "subfolders": [
24 {
25 "name": "access construction area",
26 "subfolders": [],
27 "files": [
28 {
29 "name": "file1.jpg",
30 "uuid": "cf0b4a7b02d2632554ddd16e62e59d91"
31 },
32 {
33 "name": "file2.gif",
34 "uuid": "2a87e89b1e06392d832a34d9c69f92b9"
35 }
36 ]
37 },
38 ...
39 ]
40 }
41 }{{/code}}
42
43 |=Return value|=Description
44 |total_space|available storage space in byte without considering current usage
45 |used_space|currently used storage space in byte (attention: files from bin which are not deleted permanently will also add to this!)
46 |structure|Directory structure of file storage. A directory is defined by a name and the contained files and sub directories. Files are defined by their name and uuid.
47 Temporarly deleted files are shown in bin and not their original directory.
48 Permanently deleted files will not be shown!
49