Créer un lien de partage

POST

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "expires_in": 604800,
    "max_downloads": 5
  }'

const response = await fetch('https://blob.squarecloud.app/v1/shares', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    object: 'prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf',
    expires_in: 7 * 24 * 60 * 60,
    max_downloads: 5,
  }),
});

{
  "status": "success",
  "response": {
    "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
    "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
    "expires_at": "2026-10-02T12:00:00.000Z",
    "max_downloads": 5,
    "password": false,
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "object_is_public": false
  }
}

string

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Create Share crée un lien (https://files.squarecloud.dev/s/...) pour remettre un fichier à des personnes : un client, une équipe, un testeur. Il fonctionne pour les fichiers publics et privés, dure jusqu’à 30 jours, peut être révoqué à tout moment et peut limiter le nombre de téléchargements du fichier. Sur Pro et Enterprise, il peut aussi demander un mot de passe. Nécessite un plan actif et les scopes blob:write et blob:read : un lien donne accès au fichier. Ouvrir le lien télécharge le fichier. Un lien protégé par mot de passe affiche d’abord une page demandant le mot de passe, dans la langue du visiteur. Le lien remet le fichier qui a été partagé, jamais ce qui est venu après : supprimer, déplacer ou changer la visibilité du fichier, ou écrire un autre fichier à son id, le fait répondre 404 immédiatement, sans consommer de téléchargement. Consultez Liens et partage pour une comparaison avec les liens temporaires.

Paramètres

string

requis

L’id du fichier à partager.

number

défaut:"86400"

Durée de validité du lien, de 60 à 2592000 secondes (30 jours).

number

Nombre de téléchargements autorisés par le lien, de 1 à 10000. Une fois épuisé, il répond 410. Sans ce paramètre, il n’y a pas de limite.

string

Un mot de passe de 8 à 128 caractères que le visiteur doit saisir avant de télécharger. Pro et Enterprise uniquement.

Pour un fichier public, le lien redirige vers son URL publique permanente, que toute personne qui l’ouvre peut continuer à utiliser. Le mot de passe, la limite de téléchargements et l’expiration ne protègent réellement que les fichiers privés.

Limites

30 liens par minute (RATE_LIMITED, 429), et jusqu’à 1000 liens actifs par compte (TOO_MANY_SHARES, 409).
Les visites de chaque lien sont limitées par IP. Les mots de passe erronés sont limités par IP et par lien.
Le téléchargement d’un fichier privé passe par un lien temporaire : 60 requêtes par minute par IP, plus la limite globale de votre compte. Pour distribuer un fichier à beaucoup de personnes, rendez-le public.

Réponse

Répond 201 Created.

string

“success” en cas de succès, “error” sinon.

object

Afficher les propriétés

string

L’id du partage. Utilisez-le avec Supprimer un partage.

string

Le lien à distribuer.

ISO 8601

Date d’expiration du lien.

number | null

La limite de téléchargements, ou null.

boolean

Indique si le lien demande un mot de passe.

string

L’id du fichier partagé.

boolean

true lorsque le fichier est public : toute personne disposant de son URL publique peut toujours le télécharger, donc révoquer, limiter ou protéger le partage ne restreint pas l’accès au fichier lui-même.

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "expires_in": 604800,
    "max_downloads": 5
  }'

const response = await fetch('https://blob.squarecloud.app/v1/shares', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    object: 'prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf',
    expires_in: 7 * 24 * 60 * 60,
    max_downloads: 5,
  }),
});

{
  "status": "success",
  "response": {
    "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
    "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
    "expires_at": "2026-10-02T12:00:00.000Z",
    "max_downloads": 5,
    "password": false,
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "object_is_public": false
  }
}

Erreurs

Code	HTTP	Quand
`INVALID_OBJECT`	400	`object` est absent, mal formé ou ne vous appartient pas.
`INVALID_EXPIRES_IN`	400	`expires_in` n’est pas un entier de 60 à 2592000.
`INVALID_MAX_DOWNLOADS`	400	`max_downloads` n’est pas un entier de 1 à 10000.
`INVALID_PASSWORD`	400	Le mot de passe ne comporte pas de 8 à 128 caractères.
`PERMISSION_DENIED`	401	Le compte n’a pas de plan actif.
`UPGRADE_REQUIRED`	403	Les mots de passe nécessitent Pro ou Enterprise.
`OBJECT_NOT_FOUND`	404	Le fichier n’existe pas.
`TOO_MANY_SHARES`	409	Le compte a 1000 liens actifs. Révoquez-en d’abord quelques-uns.
`RATE_LIMITED`	429	Plus de 30 liens en une minute.

Voir aussi

SDK Blob : blob.shares.create()

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "expires_in": 604800,
    "max_downloads": 5
  }'

const response = await fetch('https://blob.squarecloud.app/v1/shares', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    object: 'prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf',
    expires_in: 7 * 24 * 60 * 60,
    max_downloads: 5,
  }),
});

{
  "status": "success",
  "response": {
    "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
    "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
    "expires_at": "2026-10-02T12:00:00.000Z",
    "max_downloads": 5,
    "password": false,
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "object_is_public": false
  }
}

Premiers pas

Objets

Uploads par morceaux

Compte

Liens de partage

S3

Créer un lien de partage

Paramètres

Limites

Réponse

Erreurs

Voir aussi

​Paramètres

​Limites

​Réponse

​Erreurs

​Voir aussi

Paramètres

Limites

Réponse

Erreurs

Voir aussi