Podrobnosti API

Seznam adresáře

Položka	Hodnota
Cesta	`GET /fileManage/list`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token

Popis: Získá seznam souborů a složek v zadaném adresáři s podporou stránkování a řazení.

Parametry požadavku

Hlavičky

Parametr	Povinný	Popis
Cookie	Ano	Ověření uživatele
X-Csrf-Token	Ano	CSRF ochranný token

Dotaz (query)

Parametr	Povinný	Typ	Výchozí	Popis
path	Ano	string	Žádná	Absolutní cesta, např. `/Volume1/Public`
page	Ne	integer	1	Číslo stránky, počínaje 1
limit	Ne	integer	50	Počet položek na stránku
rule	Ne	string	Žádná	Pole pro řazení: `time` / `size` / `nature` / `file_type` / `owner` / `del_time` / `a_time`
order	Ne	boolean	true	`true` = sestupně, `false` = vzestupně

Příklad požadavku

curl -X GET "https://{ip}:5443/fileManage/list?path=/Volume1/Public&rule=time&order=true" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789"

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": {
    "data": [
      {
        "name": "Music",
        "path": "/Volume1/Public/Music",
        "volume": "Volume1",
        "f_type": "folder",
        "size": 4096,
        "size_friendly": "4.0KB",
        "owner": "admin",
        "permission": "rwxr-xr-x",
        "m_time_stamp": 1722155400,
        "hidden": false
      },
      {
        "name": "report.pdf",
        "path": "/Volume1/Public/report.pdf",
        "volume": "Volume1",
        "f_type": "file",
        "size": 2516582,
        "size_friendly": "2.4MB",
        "owner": "admin",
        "permission": "rw-r--r--",
        "m_time_stamp": 1722114900,
        "hidden": false
      }
    ],
    "total": 2
  },
  "is_login": true,
  "time": 0.047
}

Klíčová pole

Pole	Popis
f_type	`folder` = složka, `file` = soubor, `app_link` = odkaz aplikace, `music` = zvukový soubor, `video` = video soubor, `image` = obrazový soubor
hidden	`true` = skrytý soubor
total	Celkový počet záznamů (informace o stránkování)

Podrobnosti souboru

Položka	Hodnota
Cesta	`GET /fileManage/folderInfoAll`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token

Popis: Získá úplné podrobnosti o souboru nebo složce, včetně oprávnění a statistik.

Parametry požadavku

Dotaz (query)

Parametr	Povinný	Popis
path	Ano	Absolutní cesta souboru nebo složky

Příklad požadavku

curl -X GET "https://{ip}:5443/fileManage/folderInfoAll?path=/Volume1/Public/Music" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789"

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": {
    "name": "Music",
    "path": "/Volume1/Public/Music",
    "volume": "Volume1",
    "f_type": "folder",
    "size": 4096,
    "owner": "admin",
    "permission": "rwxr-xr-x",
    "acl_type": 0,
    "file_quantity": 150,
    "folder_quantity": 12,
    "child_folders_info": [
      {"name": "Albums", "path": "/Volume1/Public/Music/Albums"}
    ],
    "m_time": "2026-07-28 14:30:00",
    "is_only_read": false
  },
  "is_login": true,
  "time": 0.159
}

Klíčová pole

Pole	Popis
acl_type	`0` = standardní oprávnění, `1` = vlastní oprávnění
file_quantity	Celkový počet souborů ve složce
folder_quantity	Celkový počet podsložek
is_only_read	`true` = souborový systém pouze pro čtení

Vytvoření souboru nebo složky

Položka	Hodnota
Cesta	`POST /fileManage/CreateFolder`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token

Popis: Vytvoří nový soubor nebo složku na zadané cestě.

Parametry požadavku

Tělo (JSON)

Parametr	Povinný	Typ	Výchozí	Popis
path	Ano	string	Žádná	Úplná absolutní cesta
type	Ano	integer	Žádná	`1` = soubor, `2` = složka
back_up	Ne	integer	0	`0` = bez zálohy, `1` = záloha

Příklad požadavku

curl -X POST "https://{ip}:5443/fileManage/CreateFolder" \
  -H "Content-Type: application/json" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789" \
  -d '{"path":"/Volume1/Public/NewFolder","type":2}'

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": {
    "name": "NewFolder",
    "path": "/Volume1/Public/NewFolder",
    "f_type": "folder",
    "size": 4096,
    "owner": "admin",
    "m_time": "2026-08-05 10:00:00"
  },
  "is_login": true,
  "time": 0.052
}

Přejmenování

Položka	Hodnota
Cesta	`POST /fileManage/folderRename`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token

Popis: Přejmenuje soubor nebo složku.

Parametry požadavku

Tělo (JSON)

Parametr	Povinný	Popis
path	Ano	Aktuální absolutní cesta
r_name	Ano	Nový název (bez cesty)

Příklad požadavku

curl -X POST "https://{ip}:5443/fileManage/folderRename" \
  -H "Content-Type: application/json" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789" \
  -d '{"path":"/Volume1/Public/OldName","r_name":"NewName"}'

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": {
    "name": "NewName",
    "path": "/Volume1/Public/NewName",
    "f_type": "folder",
    "m_time": "2026-08-05 10:05:00",
    "owner": "admin"
  },
  "is_login": true,
  "time": 0.005
}

Přesunutí nebo kopírování

Položka	Hodnota
Cesta	`POST /fileManage/moveFiles`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token

Popis: Hromadně přesune nebo zkopíruje soubory/složky do cílového adresáře.

Parametry požadavku

Tělo (JSON)

Parametr	Povinný	Typ	Výchozí	Popis
paths	Ano	array	Žádná	Pole absolutních cest zdrojů
to_path	Ano	string	Žádná	Absolutní cesta cílového adresáře
type	Ano	integer	Žádná	`1` = kopírování, `2` = přesunutí
on_conflict	Ne	integer	1	`1` = přejmenovat, `2` = přepsat, `3` = přeskočit

Příklad požadavku

curl -X POST "https://{ip}:5443/fileManage/moveFiles" \
  -H "Content-Type: application/json" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789" \
  -d '{"paths":["/Volume1/Public/a.pdf"],"to_path":"/Volume1/Archive","type":2,"on_conflict":1}'

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": "task_20260805_100000_abc123",
  "is_login": true,
  "time": 0.018
}

data je ID úlohy (asynchronní operace) nebo prázdný řetězec (synchronní dokončení).

Smazání

Položka	Hodnota
Cesta	`DELETE /fileManage/folder/del`
Ověřování	Pouze Cookie, bez CSRF

Popis: Hromadně smaže soubory/složky s možností přesunout do Koše nebo vynutit smazání.

Parametry požadavku

Tělo (JSON)

Parametr	Povinný	Typ	Výchozí	Popis
paths	Ano	array	Žádná	Pole absolutních cest ke smazání
is_force	Ne	boolean	false	`true` = vynutit smazání (nevratné), `false` = přesunout do Koše

Příklad požadavku

curl -X DELETE "https://{ip}:5443/fileManage/folder/del" \
  -H "Content-Type: application/json" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123" \
  -d '{"paths":["/Volume1/Public/a.pdf"],"is_force":false}'

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": true,
  "is_login": true,
  "time": 0.0007
}

data má hodnotu true, pokud byla úloha úspěšně vytvořena, jinak false.

Obnovení z Koše

Položka	Hodnota
Cesta	`POST /fileManage/restoreRecycle`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token

Popis: Obnoví smazané soubory z Koše na jejich původní cesty.

Parametry požadavku

Tělo (JSON)

Parametr	Povinný	Typ	Výchozí	Popis
paths	Ano	array	Žádná	`[{"path":"absolute_path"}]`
on_conflict	Ano	integer	Žádná	`1` = přejmenovat, `2` = přepsat, `3` = přeskočit

Příklad požadavku

curl -X POST "https://{ip}:5443/fileManage/restoreRecycle" \
  -H "Content-Type: application/json" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789" \
  -d '{"paths":[{"path":"/Volume1/Public/a.pdf"}],"on_conflict":1}'

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": true,
  "is_login": true,
  "time": 0.0007
}

Příprava stahování (vrácení ticketu)

Položka	Hodnota
Cesta	`POST /fileManage/prepareFileDownload`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token

Popis: Vygeneruje stahovací ticket pro následné stažení souboru.

Parametry požadavku

Tělo (JSON)

Parametr	Povinný	Popis
paths	Ano	Absolutní cesta souboru; více cest oddělených čárkami (bez mezer)

Příklad požadavku

curl -X POST "https://{ip}:5443/fileManage/prepareFileDownload" \
  -H "Content-Type: application/json" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789" \
  -d '{"paths":"/Volume1/Public/a.pdf"}'

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": {
    "ticket": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  },
  "is_login": true,
  "time": 0.071
}

Nahrání souboru

Položka	Hodnota
Cesta	`POST /fileManage/upload`
Ověřování	Vyžadováno přihlášení, vyžadován CSRF Token
Kódování	`multipart/form-data`

Popis: Nahraje soubor po částech s podporou velkých souborů a hromadného nahrávání.

Parametry požadavku

Hlavičky

Parametr	Povinný	Popis
Cookie	Ano	Ověření uživatele
X-Csrf-Token	Ano	CSRF ochranný token

Formulářová data

Parametr	Povinný	Typ	Popis
filename	Ano	string	Název souboru
dir	Ano	string	Absolutní cesta cílového adresáře
file	Ano	file	Binární data aktuální části
task_id	Ano	string	Jedinečný identifikátor této úlohy nahrávání
offset	Ano	integer	Počáteční pozice aktuální části (v bajtech)
block_size	Ano	integer	Velikost části (v bajtech)
block_hash	Ano	string	CRC32 aktuální části
file_hash	Ano	string	CRC32 celého souboru (vyžadováno pouze u poslední části)
task_size	Ano	integer	Zbývající celková velikost souboru (v bajtech)
last_mod_time	Ano	integer	Čas změny souboru (časové razítko Unix)
is_task_center	Ano	boolean	`true` = úloha centra úloh
index	Ano	integer	Pořadové číslo souboru, počínaje `0`
upload_operation_type	Ano	integer	`1` = přejmenovat, `2` = přepsat, `3` = přeskočit
auto_create_dir	Ano	boolean	`true` = automatické přejmenování, `false` = ne
folder_path	Ne	string	Cesta nadřazeného adresáře (vyžadováno při nahrávání složky)
folder_counts	Ne	integer	Celkový počet souborů (vyžadováno při nahrávání složky)

Příklad požadavku

curl -X POST "https://{ip}:5443/fileManage/upload" \
  -H "Cookie: userName=admin; TMSESSNAME=abc123; X-Csrf-Token=xyz789" \
  -H "X-Csrf-Token: xyz789" \
  -F "filename=a.txt" \
  -F "dir=/Volume1/Public" \
  -F "file=@a.txt" \
  -F "task_id=123456" \
  -F "offset=0" \
  -F "block_size=1024" \
  -F "block_hash=0ffff" \
  -F "file_hash=0ffff" \
  -F "task_size=1024" \
  -F "last_mod_time=1722780000" \
  -F "is_task_center=true" \
  -F "index=0" \
  -F "upload_operation_type=1" \
  -F "auto_create_dir=false"

Příklad odpovědi

{
  "code": true,
  "code_num": 0,
  "code_msg": "",
  "data": true,
  "is_login": true,
  "time": 0.099
}

data má hodnotu true, pokud byla část úspěšně nahrána.

Seznam adresáře​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Podrobnosti souboru​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Vytvoření souboru nebo složky​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Přejmenování​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Přesunutí nebo kopírování​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Smazání​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Obnovení z Koše​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Příprava stahování (vrácení ticketu)​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Nahrání souboru​

Parametry požadavku​

Příklad požadavku​

Příklad odpovědi​

Seznam adresáře

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Podrobnosti souboru

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Vytvoření souboru nebo složky

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Přejmenování

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Přesunutí nebo kopírování

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Smazání

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Obnovení z Koše

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Příprava stahování (vrácení ticketu)

Parametry požadavku

Příklad požadavku

Příklad odpovědi

Nahrání souboru

Parametry požadavku

Příklad požadavku

Příklad odpovědi