Aurabase Logo
aura tabanıdokümanlar
Aurabase Logo
aura tabanıdokümanlar
API'si/Storage/Télécharger / servir un objet

Télécharger / servir un objet

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

Sert les octets d'un objet. Les transformations d'image sont demandées en paramètres de requête et leur résultat est mis en cache par combinaison unique.

#
Request

Query params

widthintegerOPSİYONEL
Largeur cible en pixels (images uniquement).
heightintegerOPSİYONEL
Hauteur cible en pixels.
fitenumOPSİYONEL
contain (défaut) · cover · fill.
formatenumOPSİYONEL
jpeg · png · webp · gif. Il n'y a ni auto, ni avif : sans ce paramètre, le format d'origine est conservé.
qualityintegerOPSİYONEL
1-100, borné côté serveur. Appliqué au seul encodage JPEG — PNG et GIF sont sans perte et l'ignorent.
rotateintegerOPSİYONEL
Rotation en degrés.
flip_h / flip_vbooleanOPSİYONEL
Miroir horizontal / vertical.
expires + sigstringOPSİYONEL
Paire produite par la génération d'URL signée. Seul moyen de lire un objet privé sans identité de projet.
#
Notlar

Contrôle d'accès

Attention
Il n'existe pas de segment public dans l'URL : le même chemin sert les objets publics et privés, et c'est le bucket qui décide. Un objet privé n'est servi qu'avec une URL signée valide, une identité de projet authentifiée, ou au propriétaire de l'objet ; une requête anonyme sur un bucket inconnu est refusée (fail-closed).
#
Notlar

Cache des dérivés

Astuce
Chaque combinaison de paramètres produit une clé de dérivé distincte, stockée sous un préfixe réservé : la transformation n'est calculée qu'une fois. ?width=300 et ?width=240 sont deux dérivés indépendants.
v1.0 · révisé 15 avr. 2026