Skip to main content
workspace 可以将应用与其他 Square Cloud 用户共享,每个用户都拥有一个角色。client.workspaces 管理 workspace,client.workspaces.members 管理其成员,client.workspaces.apps 管理共享的应用。 创建 workspace 需要 Standard、Pro 或 Enterprise 套餐。 示例使用创建客户端中的 client。workspace_id 是某个 workspace 的 ID(workspaces.list() 会列出它们),app_id 是你的某个应用的 ID,member_id 是某个成员的 id。

Workspaces

所有者不能离开(400 CANNOT_LEAVE_OWNER):请改为删除该 workspace。

成员

添加成员需要一个邀请码,由该成员通过 members.invite_code() 生成。邀请码有效期为 5 分钟。
角色(group):view、manager、maintain 和 admin。调用你的角色不允许的方法会返回 403 PERMISSION_DENIED。

共享应用

一个 workspace 最多可容纳 100 个应用(400 APPLICATIONS_LIMIT_REACHED)。

操作共享应用

要操作与你共享的应用,请将组合 ID <appId>-<workspaceId> 传给任意 client.apps 方法。workspaces.get() 和 workspaces.list() 返回原始 ID,因此需要你自行构建:

错误

workspace 路由将 ID 放在请求体中发送,因此空 ID 会由服务器返回 400 INVALID_ID(而不是本地错误)。例外是 workspaces.get(),它的 ID 位于 URL 路径中:在那里,空 ID 会在本地失败。

后续步骤

AI

通过 AI Gateway 调用 chat completions。

Workspace API 参考

这些方法背后的 REST 端点。

用 CLI 管理 workspace

在终端中完成同样的操作。