Sign inGet Started

工作区

工作区是 Bird 中的工作单元。它包含你的域名、API 密钥、发送记录和团队访问权限。仪表板以工作区为中心,所有操作都在工作区内进行。你的账户绑定到单个区域,并保存你的账单信息。

区域

你的账户固定在一个区域,目前为 us1(美国)或 eu1(欧盟)。区域在注册时选定,之后无法更改:你的数据和发送基础设施都在该区域,API 流量发往该区域的主机 https://us1.platform.bird.com 或 https://eu1.platform.bird.com。区域嵌入在每个 API 密钥前缀中(bk_us1_...),因此请求会自动路由。请参阅基础 URL 与区域了解路由规则以及请求到达错误区域时的处理方式。

请求如何找到你的工作区

Bird 的 API 使用扁平路由(/v1/email/messages、/v1/sms/messages),路径中没有工作区段。凭证承载上下文:一个 API 密钥绑定到你的工作区,同时确定其组织和区域,因此请求只需密钥本身即可。如果请求中指定的上下文与其密钥矛盾,该请求会被拒绝并返回格式错误(400),而不是被静默重新解释。
请求是否被允许是另一个问题,对于 API 密钥由密钥权限范围决定,对于在仪表板中操作的用户由角色决定。

关闭账户

关闭账户是永久性操作,且刻意设计为不易误操作。账户关闭由所有者在账户设置中发起,并触发一封确认邮件。在你点击 Bird 发送的链接进行确认之前,不会发生任何变化。
确认后:
  • 立即锁定。 你的账户从仪表板中消失,其 API 密钥停止认证并被吊销,发送停止,所有活跃订阅被取消。
  • 随后有 7 天的宽限期。 数据、配置和团队成员关系保持不变。关闭确认邮件中附有取消链接,在宽限期内点击该链接即可恢复访问。所有内容都会恢复,但 API 密钥除外,它们在锁定时已被吊销,需要重新签发。
  • 之后清除不可逆转。 宽限期结束后,清理流程运行并回收所有内容:域名、屏蔽列表、Webhook 端点、模板、成员关系、数据。清除一旦开始,任何内容均无法恢复。

后续步骤

相关资源

继续查阅此主题的文档、指南和示例。资源为英文。

获取实施简报