邀请成员

添加一位同事只需要一个链接。管理员创建邀请，你把 URL 发给对方，对方在登录状态下打开链接并选择 接受邀请，就会立刻加入组织。

开始之前

前提条件	原因
你是当前组织的管理员	邀请是仅限管理员的操作
当前工作区不是你的个人工作区	个人工作区不能有成员

如果侧边栏顶部的切换器显示 个人，请先创建一个组织 — 参见 切换组织。

创建邀请

1. 在侧边栏中打开 团队。
2. 选择 邀请。
3. 输入同事的邮箱地址。
4. 选择一个角色：成员——可部署并使用 API 或 管理员——完全访问权限。
5. 选择 创建邀请。

Superheat 会返回一个链接：

https://console.superheat.cloud/join?token=<token>

在关闭对话框之前先复制它。该令牌只显示一次，之后无法再取回。如果弄丢了，撤销这个邀请并重新创建一个。

仍然要把链接当作凭证对待

邀请与你输入的邮箱地址绑定：只有当前用这个地址登录的人才能接受——看的是这次登录的邮箱，而不是账户创建时记下的邮箱。其他任何人打开链接都会被告知邀请不存在或发给了别的邮箱，即使令牌完全有效。

这是真实的限制，不是形式 — 但令牌仍然出现在 URL 中，会通过粘贴的链接和 Referer 头泄露。请直接发给本人，不要发到共享频道；一旦流向不该去的地方，立即撤销。

手机号账户无法接受邀请

邀请只能按邮箱地址创建，邀请对话框里也写着：“邀请仅支持邮箱；通过手机号登录的成员暂时无法被邀请。”只用手机号登录的账户没有邮箱，因此无法接受任何邀请：打开链接只会看到「此邀请不存在，或发送到的邮箱与你当前登录的邮箱不同。」，仪表盘上也不会出现邀请横幅。被邀请的人需要在登录页选择邮箱，用被邀请的地址登录。

同事如何接受邀请

有两条路径，最终得到的成员身份完全相同。

路径	他们要做什么
链接	登录，打开 /join?token=…，选择 接受邀请
在控制台中	用被邀请的邮箱地址登录，然后在仪表盘上写着“你已被邀请以 … 身份加入 …”的横幅上选择 接受

两条路径都需要以被邀请的地址登录；横幅只是便利入口，不是第二种进入方式。

打开链接后，在任何事情发生之前，页面会先说明他们要接受的是什么：标题为加入 {org}，写明是谁邀请的、以哪个角色加入，以及邀请何时过期。管理员邀请还会多一行，说明管理员能做什么。接受邀请就会加入；暂不加入则让邀请保持未使用。

通过链接接受之后，页面显示你已加入 {org}，并询问现在是否切换过去——切换到 {org}，或者留在当前工作区。工作区不会在不经询问的情况下切换。如果他们还没有账户，需要先在登录页选择邮箱，用被邀请的地址通过免密登录创建一个 — 参见 创建账户。

如果出了问题，页面会显示下面的提示：

提示信息	发生了什么
此邀请已被使用。	每个邀请只能使用一次。请重新创建一个。
此邀请已过期。请让管理员重新发送。	邀请自创建起 7 天有效。
此邀请不存在，或发送到的邮箱与你当前登录的邮箱不同。	邀请已被撤销（或者因为发出它的管理员被移除、被改成成员而随之撤回）、令牌有误或被截断 — 或者你登录用的邮箱与被邀请的地址不是同一个，或者你登录的是没有邮箱的手机号账户。请退出后用被邀请的邮箱地址重新登录。
此邀请已失效——发送者已不再是管理员。请向现任管理员索取新的邀请。	创建它的管理员已不再是这个组织的管理员，邀请也就不再有效。
缺少邀请令牌	打开 URL 时没有带上 ?token= 部分。请复制完整链接。

待处理的邀请

团队 页面会列出所有尚未被接受且尚未过期的邀请，并显示角色和过期日期。管理员能看到这个列表，成员看不到。

• 撤销 会删除该邀请。链接立刻失效。
• 邀请一旦被接受、被撤销或超过 7 天，就会从列表中消失。
• 移除一名管理员，或把他改为成员，会撤回他创建的所有待处理邀请。

通过 API 操作

创建邀请是管理员操作，因此需要会话令牌。shk_ API 密钥在所有管理员端点上都会被拒绝，即使创建它的人是管理员。

curl -X POST "$SUPERHEAT_API/v1/orgs/current/invites" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Org-Id: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"email": "teammate@company.com", "role": "member"}'

{
  "invite": {
    "id": "0f1c9e2a-8a1e-4a1b-9a52-2f3f0b6f6a11",
    "email": "teammate@company.com",
    "role": "member",
    "created_at": "2026-03-04T10:12:00Z",
    "expires_at": "2026-03-11T10:12:00Z"
  },
  "invite_url": "https://console.superheat.cloud/join?token=…"
}

invite_url 是令牌唯一出现的地方。

端点	谁可以调用
POST /v1/orgs/current/invites	管理员，仅限会话令牌
GET /v1/orgs/current/invites	管理员 — 未接受、未过期的邀请
DELETE /v1/orgs/current/invites/{invite_id}	管理员 — 撤销
GET /v1/orgs/invites/pending	任何已登录用户 — 发给其邮箱的邀请；手机号账户总是得到空列表
POST /v1/orgs/invites/preview	任何已登录用户，请求体为 {"token": "…"} — 返回 org_id、org_name、role、inviter 和 expires_at，不会接受邀请
POST /v1/orgs/invites/{invite_id}/accept	被邀请的用户，接受其中一个
POST /v1/orgs/invites/accept	任何已登录用户，请求体为 {"token": "…"}

新成员第一天就拥有什么

他们立刻共享组织的余额、实例、模板、API 密钥和用量日志。他们不共享你的 SSH 密钥 — 这些留在每个用户自己的账户上。团队 页面按邮箱列出每位成员；没有邮箱的手机号账户（例如用手机号注册、自己创建了组织的管理员）显示为带国际区号的手机号，例如 +8613800138000。成员具体可以做什么，参见 角色与权限；哪些东西不会越过边界，参见 切换组织。

相关内容

• 角色与权限
• 切换组织
• 组织