Propojené aplikace – ukládání z jiných programů (API a WebDAV)

Propojené aplikace ukládají soubory do vašeho disku samy – účetnictví, CRM, e-shop, zálohovací software nebo vlastní skript. Každá aplikace má vlastní klíč, vidí jen svou složku a může mít vlastní limit místa. Služba Připojení aplikací se objednává v disku: klikněte na své jméno vpravo nahoře → Propojené aplikace (jen správce účtu).

1. Objednejte službu a založte aplikaci: název, složka (výchozí Aplikace/název) a případně limit místa.
2. Zobrazí se klíč aplikace (začíná ndk_). Ukáže se jen jednou – vložte ho do nastavení programu. Když se ztratí, vygenerujte nový, starý tím přestane platit.
3. Program pak ukládá přes API nebo přes WebDAV.

WebDAV: adresa https://nexedisk.eu/dav, uživatel je přihlašovací jméno aplikace (app-…@aplikace.nexedisk, najdete ho u aplikace) a heslo je klíč aplikace. Program uvidí jen složku aplikace.

API (REST): základní adresa https://nexedisk.eu/api/v1, v každém požadavku hlavička Authorization: Bearer ndk_…. Cesty se píšou od složky aplikace, např. /Faktury/2026/f-001.pdf.

• GET /me – aplikace, složka, limit, obsazeno, volno
• GET /files?path=/slozka – obsah složky (id, name, path, isDir, size, mime, modified, etag)
• GET /content?path=/soubor.pdf nebo GET /files/{id}/content – stažení (umí i část souboru, Range)
• PUT /content?path=/slozka/soubor.pdf – uložení, tělo požadavku je obsah souboru, chybějící složky se založí; s hlavičkou If-Match: <etag> se uloží jen tehdy, když se soubor mezitím nezměnil
• POST /folders s tělem {"path":"/slozka"} – nová složka
• PATCH /files/{id} s tělem {"name":"…","parentPath":"/jinam"} – přejmenování a přesun
• DELETE /files/{id} – smazání do koše (30 dní jde vrátit)
• GET /files/{id}/versions – předchozí verze souboru (30 dní)
• POST /files/{id}/links s tělem {"days":7,"password":"…"} – odkaz ke sdílení
• GET /changes?since=<čas> – co se změnilo od minulého dotazu (pro synchronizaci; čas pro příští dotaz je v odpovědi)

Chyby vrací JSON {"error":"…","code":"…"}: 401 neplatný klíč, 402 služba není aktivní, 403 aplikace vypnutá, 404 nenalezeno, 409 konflikt, 412 soubor se změnil (ETag), 423 účet jen pro čtení, 429 příliš mnoho požadavků (výchozí limit 600 za minutu), 507 plný limit místa.

Přepsaný soubor se uloží jako nová verze, předchozí obsah zůstává 30 dní. Všechny operace aplikace najdete v Historii disku. U každé aplikace vidíte obsazené místo a počet požadavků; když se aplikace blíží limitu (80 a 95 %), přijde správcům účtu e-mail.