Side Space

API 参考

Storage

A person's own S3-compatible buckets that spaces keep their files in (encrypted). Signed-in sessions only.

5 个接口 · 概览

GET/v1/storage

My storage profiles (never the secret key)
Bearer 令牌

响应

  • 200
    Profiles
    object
    › 展开字段
    • itemsStorageProfile[]
      › 11 个字段
      • idstring必填
      • namestring必填
      • kindstring必填
        s3
      • endpointstring必填
        Empty for AWS S3
      • bucketstring必填
      • regionstring必填
      • prefixstring必填
        Keys go under it; empty or ends in /
      • access_keystring必填
      • spacesinteger必填
        How many spaces keep their files in it
      • created_atTimestamp必填
      • updated_atTimestamp必填
  • 4xx/5xx
    Error
    Error
请求示例
curl "https://side.example.com/v1/storage" \
  -H "Authorization: Bearer $SIDESPACE_TOKEN"
响应示例 · 200
{
  "items": [
    {
      "id": "id",
      "name": "A001_C003.mov",
      "kind": "s3",
      "endpoint": "endpoint",
      "bucket": "bucket",
      "region": "region",
      "prefix": "prefix",
      "access_key": "access_key",
      "spaces": 1,
      "created_at": "2026-11-14T09:30:00Z",
      "updated_at": "2026-11-14T09:30:00Z"
    }
  ]
}

POST/v1/storage

Add a bucket. The gateway first writes, reads, lists and deletes a test object in it; 400 says what failed.
Bearer 令牌

请求体StorageRequest application/json

  • namestring
  • kindstring
    s3
    default "s3"
  • endpointstring
    https URL of an S3-compatible service (R2, B2, OSS, MinIO…); empty for AWS S3
  • bucketstring
  • regionstring
    default "us-east-1"
  • prefixstring
  • access_keystring
  • secret_keystring
    Stored sealed; never returned. Required with access_key: the gateway never lends its own credentials.

响应

请求示例
curl -X POST "https://side.example.com/v1/storage" \
  -H "Authorization: Bearer $SIDESPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"A001_C003.mov","kind":"s3","endpoint":"endpoint"}'
响应示例 · 201
{
  "id": "id",
  "name": "A001_C003.mov",
  "kind": "s3",
  "endpoint": "endpoint",
  "bucket": "bucket",
  "region": "region",
  "prefix": "prefix",
  "access_key": "access_key",
  "spaces": 1,
  "created_at": "2026-11-14T09:30:00Z",
  "updated_at": "2026-11-14T09:30:00Z"
}

GET/v1/storage/{id}

Bearer 令牌

参数 · 路径

  • idstring必填

响应

请求示例
curl "https://side.example.com/v1/storage/id" \
  -H "Authorization: Bearer $SIDESPACE_TOKEN"
响应示例 · 200
{
  "id": "id",
  "name": "A001_C003.mov",
  "kind": "s3",
  "endpoint": "endpoint",
  "bucket": "bucket",
  "region": "region",
  "prefix": "prefix",
  "access_key": "access_key",
  "spaces": 1,
  "created_at": "2026-11-14T09:30:00Z",
  "updated_at": "2026-11-14T09:30:00Z"
}

PATCH/v1/storage/{id}

Rename, or change credentials or region (checked like an add). Kind, endpoint, bucket and prefix are fixed while spaces use it (409).
Bearer 令牌

参数 · 路径

  • idstring必填

请求体StorageRequest application/json

  • namestring
  • kindstring
    s3
    default "s3"
  • endpointstring
    https URL of an S3-compatible service (R2, B2, OSS, MinIO…); empty for AWS S3
  • bucketstring
  • regionstring
    default "us-east-1"
  • prefixstring
  • access_keystring
  • secret_keystring
    Stored sealed; never returned. Required with access_key: the gateway never lends its own credentials.

响应

请求示例
curl -X PATCH "https://side.example.com/v1/storage/id" \
  -H "Authorization: Bearer $SIDESPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"A001_C003.mov","kind":"s3","endpoint":"endpoint"}'
响应示例 · 200
{
  "id": "id",
  "name": "A001_C003.mov",
  "kind": "s3",
  "endpoint": "endpoint",
  "bucket": "bucket",
  "region": "region",
  "prefix": "prefix",
  "access_key": "access_key",
  "spaces": 1,
  "created_at": "2026-11-14T09:30:00Z",
  "updated_at": "2026-11-14T09:30:00Z"
}

DELETE/v1/storage/{id}

Remove a profile no space uses (409 otherwise)
Bearer 令牌

参数 · 路径

  • idstring必填

响应

  • 204
    Removed
  • 4xx/5xx
    Error
    Error
请求示例
curl -X DELETE "https://side.example.com/v1/storage/id" \
  -H "Authorization: Bearer $SIDESPACE_TOKEN"