Skip to main content
Blob Storage offre trois façons de remettre un fichier à quelqu’un. Choisissez selon la durée de vie nécessaire du lien et selon que vous devez pouvoir le retirer ou non.

​
URL publiques

Un fichier public a une URL permanente sur le CDN :
Utilisez-la pour les ressources que vous intégrez : images sur un site, pièces jointes dans un bot, fichiers récupérés par d’autres services. Les fichiers hérités, stockés avant la mise à jour de septembre 2026, conservent leur URL sur https://public-blob.squarecloud.dev/<user_id>/<path> pendant 30 jours, jusqu’au 25 octobre 2026. Déplacez-les avec Object Copy (move: true) pour obtenir une URL sur blob.squarecloud.dev.
Avec security_hash=true (la valeur par défaut pour les fichiers privés et les jetons d’envoi sans nom), le chemin reçoit un suffixe aléatoire, de sorte que l’URL ne peut pas être devinée à partir du nom.

​
Liens temporaires

Téléchargement d’objet signe un lien vers un fichier, valable de 60 secondes à 24 heures (1 heure par défaut). Utilisez-le pour livrer un fichier privé sur le moment : un bouton de téléchargement, une pièce jointe d’e-mail, un fichier que votre backend transmet à un autre service.
  • Le lien ne nécessite aucun identifiant et ne peut pas être révoqué : il cesse de fonctionner uniquement lorsqu’il expire ou lorsque le fichier est supprimé, déplacé ou change de visibilité. Gardez une durée de vie courte.
  • Il prend en charge Range (téléchargements reprenables et navigation dans les vidéos) et les requêtes conditionnelles (If-None-Match, If-Modified-Since).
  • Vous pouvez forcer un téléchargement et choisir le nom de fichier que le navigateur enregistre (disposition et filename).
  • Pour un fichier public sans ces surcharges, Téléchargement d’objet renvoie l’URL publique elle-même.
  • Un lien accepte 60 requêtes par minute par IP, en plus d’une limite globale pour l’ensemble des liens de votre compte. Au-delà, il répond 429 en texte brut. Pour distribuer un fichier à beaucoup de personnes, rendez-le public : les fichiers publics sont servis par le CDN, sans cette limite. Un lien expiré ou invalide répond 404.

​
Liens de partage

Créer un partage crée un lien avec sa propre page, destiné à des personnes plutôt qu’à des programmes : envoyer un fichier à un client, un rapport à une équipe, un build à un testeur.
  • Il dure de 60 secondes à 30 jours (24 heures par défaut).
  • Il peut être révoqué à tout moment avec Supprimer un partage, et il est listé par Lister les partages.
  • max_downloads limite le nombre de téléchargements possibles du fichier. Le décompte est exact, même en cas de téléchargements simultanés. Une fois la limite atteinte, le lien répond 410.
  • Sur Pro et Enterprise, un password fait que la page le demande avant le téléchargement. Les tentatives erronées sont limitées par IP et par lien. Un lien avec mot de passe créé avant un passage à un plan inférieur conserve son mot de passe.
  • La page suit la langue du navigateur du visiteur (anglais, portugais, espagnol, français, allemand, italien, japonais et chinois).
  • Le compte peut avoir jusqu’à 1000 liens de partage actifs.
  • Le téléchargement d’un fichier privé passe par un lien temporaire, avec les mêmes limites : 60 requêtes par minute par IP, plus la limite globale de votre compte.
Un lien de partage est lié au fichier tel qu’il était au moment de la création du lien. Supprimer le fichier, le déplacer ou le renommer, ou changer sa visibilité fait répondre le lien 404 immédiatement, avant toute page de mot de passe et sans consommer de téléchargement. La visite suivante le retire de Lister les partages.
Un lien de partage vers un fichier public se termine par une redirection vers l’URL publique permanente du fichier. Quiconque l’ouvre obtient cette URL et peut à nouveau télécharger le fichier sans passer par le lien : le mot de passe, la limite de téléchargements et l’expiration ne protègent donc réellement que les fichiers privés. Lorsque la protection compte, partagez un fichier privé.

​
Rendre un fichier privé ou public

Changez la visibilité avec Mise à jour d’objet (private: true ou false), ou lors d’une copie avec Copie d’objet.
  • L’id de l’objet change : pub/... devient prv/... et inversement. Enregistrez le nouvel id renvoyé dans la réponse.
  • Rendre un fichier privé supprime la copie publique avant que la requête ne réponde. Son URL publique cesse de fonctionner, et les caches du CDN l’abandonnent en environ 60 secondes. Si la copie publique ne peut pas être supprimée, l’objet répond VISIBILITY_CHANGE_FAILED et reste public, afin que vous puissiez réessayer.
  • Rendre un fichier public nécessite un plan actif. Le rendre privé est toujours autorisé, même sans plan.
  • Les liens de partage et les liens temporaires vers le fichier cessent de fonctionner, car ils pointent vers l’ancien id. Créez-en de nouveaux pour le nouvel id.
Un fichier qui était public a pu être téléchargé ou mis en cache par d’autres avant que vous ne le rendiez privé. Envoyez les fichiers sensibles en privé dès le départ (private=true).