Space

最終更新: 2026年6月22日

Space は 1 つのプロジェクトのコンテンツがすべて格納される作業領域です。コンテンツ構造を定義する Content Type、実データである Content、画像やファイルなどの Media、言語設定である Locale が、すべて 1 つの Space の中に存在します。1 つの Space は上位の入れ物である Organization の下に属し、通常はサービス 1 つにつき Space を 1 つ置きます。

自分が所属する Space の一覧は GET /me/space-memberships で取得します。

リソース構造

以下は Space「DailyWear ショッピングモール」の単一取得レスポンスです。sys（システム属性）と本文属性 name を持ちます。

{
  "sys": {
    "id": "HnQ32YiH",
    "type": "Space",
    "organization": { "sys": { "id": "ilLRJxDp", "type": "Refer", "targetType": "Organization" } },
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T14:56:04.737Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-14T14:56:58.670Z",
    "version": 2
  },
  "name": "DailyWear ショッピングモール"
}

主なキー:

  • name: Space の名前です（1～64 文字）。プロジェクトやサービスの表示名です。
  • organization: この Space が属する上位の Organization を指す Refer<Organization> です。
  • plan: この Space のサブスクリプションプランを指す Refer<Plan> です（例: free）。

システム属性 (sys) と本文

すべての Space は共通のシステム属性を sys オブジェクトに持ちます。organization は Refer<Organization>、plan は Refer<Plan>、createdBy・updatedBy は Refer の形（{ "sys": { "id", "type": "Refer", "targetType" } }）で入ります。

属性型説明
idstringリソースの一意な識別子。
typestringリソースの種類。Space は常に "Space"。
organizationRefer<Organization>この Space が属する上位の Organization。
planRefer<Plan>サブスクリプションプラン。例: free。
createdByRefer<User>作成したユーザー。
createdAtstring (date-time)作成日時。
updatedByRefer<User>最後に更新したユーザー。
updatedAtstring (date-time)最終更新日時。
versioninteger (≥1)リソースのバージョン。更新するたびに 1 ずつ上がります。

本文属性:

属性型説明
namestring (1～64)Space 名。作成・更新時に指定します。
descriptionstring (1～128)Space の説明。任意項目です。
iconstring (読み取り) / object (書き込み)Space のアイコン。レスポンスでは画像 URL の文字列です。更新リクエストでは、アップロードしたファイルを指すオブジェクト { "upload": { "sys": { ..., "targetType": "Upload" } } } として送ります（Upload API で取得した Upload を参照）。

Space は発行（publish）の概念がない設定リソースです。そのため Content・Media と異なり sys に publish・archive・status がなく、version のみを持ちます。version は Space を更新するたびに上がります。

API

以下のすべてのエンドポイントの基準 URL は https://cma.weegloo.com/v1 で、Authorization ヘッダーに CMA を認証する Bearer トークンが必要です。更新・部分更新では、楽観的同時実行制御のために X-Weegloo-Version ヘッダー（現在のリソースの sys.version）を併せて送る必要があります。作成と削除にはこのヘッダーはありません。一覧・作成・更新・部分更新・削除は上位の Organization パス（/organizations/{organizationId}/spaces）の下にあります。単一取得は以下のように /spaces/{spaceId} の直接パスで行えます（上位の Organization パス /organizations/{organizationId}/spaces/{spaceId} でも単一取得が可能です）。

  • Organization: この Space が属する上位の Organization。
  • Space Membership: Space のメンバーと、自分が所属する Space の取得。
  • Locale: Space の言語設定。