> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Liens et partage

> URL publiques, liens temporaires et liens de partage dans Blob Storage : quand utiliser chacun, combien de temps ils durent et ce qui se passe lorsqu'un fichier change de visibilité.

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 publique                                                       | Lien temporaire                                                | Lien de partage                                               |
| ------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------- | ------------------------------------------------------------- |
| Créé par                  | [Object Post](/fr/blob-reference/endpoint/post) (fichiers publics) | [Téléchargement d'objet](/fr/blob-reference/endpoint/download) | [Créer un partage](/fr/blob-reference/endpoint/shares-create) |
| Adresse                   | `blob.squarecloud.dev/pub/...`                                     | `files.squarecloud.dev/d/...`                                  | `files.squarecloud.dev/s/...`                                 |
| Fonctionne sur            | Fichiers publics                                                   | Fichiers publics et privés                                     | Fichiers publics et privés                                    |
| Durée de vie              | Tant que le fichier est public                                     | 60 secondes à 24 heures                                        | 60 secondes à 30 jours                                        |
| Révocable                 | Rendre le fichier privé                                            | Non                                                            | Oui                                                           |
| Limite de téléchargements | Non                                                                | Non                                                            | Optionnelle, 1 à 10000                                        |
| Mot de passe              | Non                                                                | Non                                                            | Optionnel (Pro et Enterprise)                                 |
| Servi depuis              | CDN global                                                         | Blob Storage                                                   | Blob Storage                                                  |

## URL publiques

Un fichier public a une URL permanente sur le CDN :

```
https://blob.squarecloud.dev/pub/<user_id>/<path>
```

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](/fr/blob-reference/endpoint/copy) (`move: true`) pour obtenir une URL sur `blob.squarecloud.dev`.

<Tip>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.</Tip>

## Liens temporaires

[Téléchargement d'objet](/fr/blob-reference/endpoint/download) 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](/fr/blob-reference/endpoint/shares-create) 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](/fr/blob-reference/endpoint/shares-delete), et il est listé par [Lister les partages](/fr/blob-reference/endpoint/shares-list).
* `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](/fr/blob-reference/endpoint/shares-list).

<Warning>
  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é.
</Warning>

## Rendre un fichier privé ou public

Changez la visibilité avec [Mise à jour d'objet](/fr/blob-reference/endpoint/update) (`private: true` ou `false`), ou lors d'une copie avec [Copie d'objet](/fr/blob-reference/endpoint/copy).

* 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 payant. 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.

<Warning>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`).</Warning>
