Datei hochladen

POST https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
Content-Type: multipart/form-data

curl -X POST "https://api.scanova.io/media/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
  -F "file=@logo.png" \
  -F "in_use=qr_logo" \
  -F "category=custom-design"

{
  "id": 4821,
  "file": "media/uploads/104/2026/09/20260908_512873_logo.png",
  "upload": null,
  "file_name": "20260908_512873_logo.png",
  "size": 48213,
  "human_readable_size": "47.08 KB",
  "original_name": "logo.png",
  "bulk_media": null,
  "mime_type": "image/png",
  "file_type": "png",
  "in_use": "qr_logo",
  "category": "custom-design",
  "created": "2026-09-08T10:15:32.120Z",
  "modified": "2026-09-08T10:15:32.120Z"
}

​

Validierung

• Erweiterung und MIME-Typ müssen beide in der Zulassungsliste der erkannten file_type-Kategorie vorhanden sein — eine Diskrepanz (z. B. eine .png-Erweiterung bei einer Datei, die tatsächlich ein PDF ist) wird abgelehnt.
• Größe wird gegen das Limit der Kategorie geprüft — außer bei pdf/doc-Dateien, wo die Plan-Quota DOCUMENT_FILE_SIZE des Kontos (in MB) die statische Obergrenze überschreibt.
• JavaScript (.js)-Uploads werden geparst, um vor der Größenprüfung zu bestätigen, dass es sich um syntaktisch gültiges JS handelt.
• SVGs werden auf eingebettete Skripte gescannt und bei einem Fund abgelehnt.
• Dateien ohne Erweiterung werden grundsätzlich abgelehnt.

​

Verwandte Themen

• Hochgeladene Dateien auflisten — sehen, was bereits hochgeladen wurde.
• Zulässige Dateitypen auflisten — vor dem Hochladen clientseitig validieren.
• Datei löschen — eine entfernen.
• Übersicht über die Management API — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.