Skip to main content
Dokument-Uploads laufen in drei Schritten: presigned URL anfordern, Datei in den privaten Speicher hochladen, anschließend den Dokumenteneintrag erstellen. Objekte unter documents/ sind nicht öffentlich lesbar — Vorschau und Download laufen immer über signierte SquadVault-URLs.

Ablauf

1. Presigned Upload-URL anfordern

Antwort:
Felder beim Erstellen zuordnen: fileKey ← key, fileUrl ← fileRef. Die API überschreibt fileUrl mit einer privaten Storage-Referenz. sizeBytes muss exakt der Byte-Länge der Datei aus Schritt 2 entsprechen.

2. Datei hochladen

Verwende denselben Content-Type und dieselbe Größe wie in Schritt 1.

3. Dokumenteneintrag erstellen

Für Download oder Vorschau später GET /documents/{documentId}/download bzw. /preview nutzen — fileUrl ist kein öffentlicher HTTP-Link.

Erlaubte Content-Types

  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.ms-excel
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • text/plain
  • image/jpeg, image/png, image/webp, image/gif
Die maximale Dateigröße hängt vom Organisationsplan ab (serverseitig geprüft).

JavaScript-Beispiel

Benötigte Berechtigung für Upload-URL und Dokument-Create: document:create.