API リファレンス

このリファレンスは、WEEGLOO をコードから直接扱う開発者向けの HTTP API 仕様です。各リソースページのエンドポイントブロックは、パス・ヘッダー・本文を直接入力して実際に呼び出せるコンソールとしてレンダリングされます。リクエストがどのような形で、レスポンスがどのような形で返ってくるかをその場で確認できます。

AI エージェントはこの HTTP API を直接呼び出さず、WEEGLOO MCP ツールを使います。以下の仕様は、フロントエンド・バックエンド・スクリプトといったアプリケーションコードから API を直接呼び出す場合のためのものです。

API と Base URL

WEEGLOO は用途に応じて分かれた複数の API を提供します。呼び出す API に合った Base URL を選んで使います。ホストを推測したり変形したりしません。

パスは /v1/... を基準とします。たとえば Space 内の Content 一覧は https://cma.weegloo.com/v1/spaces/{spaceId}/contents です。

識別情報とトークン

WEEGLOO には互いに完全に分離した 2 つの識別情報体系があります。どの識別情報が発行したトークンかによって、呼び出せる API が決まります。

Weegloo User は WEEGLOO プラットフォームアカウントです。ソーシャルログインなどで初めてログインすると、その場でアカウントが作成されます(初回ログインがそのままサインアップ)。ただし特定の Space のコンテンツを扱うには、その Space のメンバーである必要があり、メンバーシップはすでに所属しているメンバーからの招待と SpaceRole の付与によって決まります。つまりアカウント自体は自由に作成できますが、どの Space に入って何ができるかはメンバーシップとロールによって制御されます。この識別情報の Bearer トークン(サーバー・CI 用の PersonalAccessToken、またはコンテンツスタジオログインで取得したトークン)は CMA・Upload・CDA を認証します。ブラウザに公開する公開配信には、トークンの代わりに権限を最小限に絞った DeliveryAccessToken(CDA)を使います。

ServiceUser は製品にサインアップした end-user です(ServiceLogin を通じてサインアップ)。サインアップを誰に開放するか、新規サインアップに管理者の承認を設けるかは ServiceLogin の設定で決めます。この識別情報の Bearer トークン(auth.weegloo.com で発行)は ACMA・ACDA と Upload を認証します。CMA・CDA には使えません。

トークンは識別情報の境界を越えません。ServiceUser のトークンを CMA・CDA に送ってはならず、Weegloo User のトークンは ACMA・ACDA の有効な呼び出し元ではありません。2 つの識別情報が共有する面は Upload だけであり、アップロード後に Media を作成する先は、識別情報に応じて CMA(Weegloo User)または ACMA(ServiceUser)に分かれます。

共通規約

以下の 4 つは特定のリソースに限定されず、すべての呼び出しに共通して適用されます。個別のリソースページはこの規約に従うことを前提とし、固有の内容のみを扱います。

• システムプロパティ (sys): すべてのリソースの sys メタデータ構造(id・version・Refer・公開状態)。
• 共通クエリパラメータ: 一覧取得(limit・order・filter)とカーソルベースのページネーション。
• 規約: レスポンスのメディアタイプ・部分更新(JSON Patch)・並行性制御(X-Weegloo-Version)。
• エラー: エラーレスポンス形式と共通コード。

リソースリファレンス

API ごとのリソース仕様は、以下のハブで扱います。

• CMA: コンテンツモデル・管理: Content Type・Content・Media・Tag・Locale と、トークン・組織・Space・ロール・Webhook・WebHosting・ServiceLogin などの管理リソース。
• CDA: 配信: 公開コンテンツを読み取り専用で配信。
• Upload: ファイルをアップロードし、Media・WebHosting の作成に使う Upload を取得。
• Auth: ServiceUser の OAuth ログイン・トークン交換。
• ACMA: アプリ会員(ServiceUser)のコンテンツ管理。
• ACDA: アプリ会員(ServiceUser)への公開コンテンツの配信。