Skip to content
HALOWERK

Datenwerk

share link

Accepts a file as canonical base64, a plain-text title, a file name and a caller-chosen password. A random 256-bit fragment link and the exact password are both required to retrieve the file. The file name and bytes are AES-256-GCM encrypted with a 32-byte key derived using scrypt (N=16384, r=8, p=1) and a fresh 32-byte salt; title, size, ID and expiry are authenticated additional data. No password, key or password hash is stored or returned. Five failed decryptions temporarily lock that.

POST https://daten.halowerk.com/v1/share-link

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
titlestringYesPlain-text heading visible to any private-link holder before password entry. Do not include sensitive metadata.
file_namestringYesDownload name without path separators or control characters; encrypted and never used as a server path.
content_base64stringYesCanonical standard base64 of up to 524288 non-personal technical bytes; empty string allowed.
passwordstringYesUnique strong share password, exact Unicode without normalization. Send separately to the recipient, never an account password.
expires_in_secondsintegerNoShare lifetime, at most 24 hours; no renewal.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "title",
    "file_name",
    "content_base64",
    "password"
  ],
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Plain-text heading visible to any private-link holder before password entry. Do not include sensitive metadata."
    },
    "file_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Download name without path separators or control characters; encrypted and never used as a server path."
    },
    "content_base64": {
      "type": "string",
      "maxLength": 699052,
      "description": "Canonical standard base64 of up to 524288 non-personal technical bytes; empty string allowed."
    },
    "password": {
      "type": "string",
      "minLength": 12,
      "maxLength": 120,
      "description": "Unique strong share password, exact Unicode without normalization. Send separately to the recipient, never an account password."
    },
    "expires_in_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 86400,
      "default": 3600,
      "description": "Share lifetime, at most 24 hours; no renewal."
    }
  }
}

Open original schema

Published input example

{
  "title": "Technical example file",
  "file_name": "example.txt",
  "content_base64": "YWJj",
  "password": "example-only-change-me-123",
  "expires_in_seconds": 3600
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’