Blob 共有の一覧

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

必須

アカウントの API キーです。これはアカウント設定で確認できます。

共有の一覧は、アカウントの共有リンクのうち、期限切れでも取り消し済みでもないものをすべて、それぞれの残りのダウンロード回数とともに返します。blob:read スコープが必要です。ファイルが削除、移動された、または公開範囲が変更されたリンクは、誰かが最初に開いた時点で一覧から外れます。

レート制限

1 分間に 20 リクエスト (RATE_LIMITED、429)。

レスポンス

string

成功した場合は “success”、失敗した場合は “error” です。

object

表示オブジェクトを切り替え

array

表示オブジェクトを切り替え

string

共有 id。

string

リンク。

string

共有されたファイルの id。

ISO 8601

リンクの有効期限。

number | null

残りのダウンロード回数。上限がない場合は null。

boolean

リンクがパスワードを要求するかどうか。

ISO 8601

リンクが作成された日時。

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"
      }
    ]
  }
}

エラー

コード	HTTP	発生する状況
`RATE_LIMITED`	429	1 分間に 20 リクエストを超えた。

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"
      }
    ]
  }
}

はじめに

オブジェクト

チャンクアップロード

アカウント

共有リンク

S3

レート制限

レスポンス

エラー

​レート制限

​レスポンス

​エラー

レート制限

レスポンス

エラー