Skip to content
Aurabase Logo
aurabase

Download/serve an object

GET/v1/storage/{project_id}/{bucket}/{key}

Serves the bytes of an object. Image transformations are requested as query parameters and their result is cached by unique combination.

Query params#

ParameterTypeRequiredDescription
widthintegernoTarget width in pixels (images only).
heightintegernoTarget height in pixels.
fitenumnocontain (default) · cover · fill.
formatenumnojpeg · png · webp · gif. There is neither autonor avif: without this parameter, the original format is preserved.
qualityintegerno1-100, bounded on the server side. Applied to JPEG encoding only — PNG and GIF are lossless and ignore it.
rotateintegernoRotation in degrees.
flip_h / flip_vbooleannoHorizontal/vertical mirror.
expires + sigstringnoPair produced by signed URL generation. Only way to read a private object without project identity.

Access control#

Attention

There is no public segment in the URL: the same path serves public and private objects, and it is the bucket that decides. A private object is only served with a valid signed URL, an authenticated project identity, or to the owner of the object; an anonymous request to an unknown bucket is refused (fail-closed).

Derivatives cache#

Tip

Each combination of parameters produces a separate derivative key, stored under a reserved prefix: the transformation is calculated only once. ?width=300 and ?width=240 are two independent derivatives.