OOsstblok

Storage & Assets

Wie Uploads durch den separaten Storage-Service fließen und wie /m/ transformierte Bilder ohne Extra-Worker ausliefert.

Upload-Flow

  1. Admin/Client POSTet an die Management-API, um eine Asset-Row anzulegen (Filename, Mime, Size). Die API gibt ein HMAC-signiertes Upload-Token mit festem Storage-Key zurück.

  2. Der Client PUTet die Bytes an /storage/v1/<key>?t=<token>. Storage verifiziert HMAC, Size und Mime und streamt nach S3.

  3. Reads laufen über /storage/v1/<key> (mit Range-Support) bzw. /storage/v1/<key>/m/<transforms> für On-the-fly-Resize/Format-Konvertierung.

Bild-Transformationen

Häng /m/<Breite>x<Höhe>/<Filter> an eine Asset-URL. Ergebnisse sind am Proxy cachebar. Beispiel: /storage/v1/spaces/1/assets/42/photo.jpg/m/800x600/filters:format(webp).