Blob List Shares

GET

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

string

requis

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

List Shares renvoie tous les liens de partage du compte qui n’ont ni expiré ni été révoqués, avec le nombre de téléchargements restants pour chacun. Nécessite le scope blob:read. Un lien dont le fichier a été supprimé, déplacé ou a changé de visibilité quitte la liste la première fois que quelqu’un l’ouvre.

Limites de débit

20 requêtes par minute (RATE_LIMITED, 429).

Réponse

string

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

object

Afficher Afficher l'objet

array

Afficher Afficher l'objet

string

L’id du partage.

string

Le lien.

string

L’id du fichier partagé.

ISO 8601

Date d’expiration du lien.

number | null

Téléchargements restants, ou null lorsqu’il n’y a pas de limite.

boolean

Indique si le lien demande un mot de passe.

ISO 8601

Date de création du lien.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

Erreurs

Code	HTTP	Quand
`RATE_LIMITED`	429	Plus de 20 requêtes en une minute.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

Premiers Pas

Objets

Upload par Morceaux

Compte

Liens de Partage

S3

Limites de débit

Réponse

Erreurs

​Limites de débit

​Réponse

​Erreurs

Limites de débit

Réponse

Erreurs