创建和撤销 API 令牌
令牌能做什么
令牌以创建它的人的身份，在创建那一刻处于活动状态的团队中工作。它只能做创建时您允许它做的事。您可以选择以下其中一项：
- 控制屏幕和场景：查看屏幕、内容和场景，在屏幕上显示内容，启动和停止场景。用于 Bitfocus Companion 时选这一项。
- 只读：查看屏幕、内容和场景，仅此而已。
- 完全访问权限，包括创建设计：以上全部，外加创建设计。
如果创建令牌的人失去了该团队的访问权限，令牌就会停止工作。
创建令牌
- 前往 设置 > 连接。
- 在 API 令牌 下，点击 新建 API 令牌 按钮。
- 为令牌起一个名称，例如场地名称或使用它的程序的名称。
- 在 访问权限 下，选择令牌可以做什么。
- 点击 创建令牌 按钮。
- 点击 复制 按钮，并把令牌存放在安全的地方，例如需要它的那个程序里。
- 点击 完成 按钮。
令牌只会显示一次。如果弄丢了，请撤销它并重新创建一个。
令牌在您创建它时处于活动状态的团队中有效。要控制另一个团队的屏幕，请先切换到该团队，再另外创建一个令牌。每个程序使用单独的令牌，这样您可以撤销其中一个，而不影响其他程序。
默认情况下，所有者和管理员可以创建令牌。这取决于您的角色。您可以按角色在 管理团队 中更改这一点。
创建令牌时发送的邮件
有人创建令牌时，创建者和账户所有者都会收到一封电子邮件。邮件会说明是哪个令牌、由谁创建、属于哪个团队、创建时间，以及它可以做什么。邮件中从不包含令牌本身。如果您没有预料到会有这个令牌，请立即撤销它。
查看您的令牌
API 令牌 卡片会为每个令牌显示：
- 名称和访问权限的类型；
- 令牌的最后四个字符，方便您区分不同的令牌；
- 团队；
- 上次使用的时间，或 从未使用。
所有者可以看到账户中每个人的令牌，其他人只能看到自己的。
撤销令牌
- 前往 设置 > 连接。
- 点击令牌旁边的 撤销 按钮。
- 再点击一次 撤销 按钮确认。
所有使用该令牌的程序会立即停止工作。
会过期的令牌
一年没有使用的令牌会被自动撤销。从未使用过的令牌，则从创建当天开始计算。如果再次需要，请创建新令牌。
数量限制
一个账户可以拥有的令牌数量有限。达到上限时，Screenbird 会请您先撤销一个令牌。
已连接的应用
通过 Screenbird 登录而不是令牌来连接的应用，会显示在同一页面上单独的 已连接应用 卡片中。点击 断开连接 按钮即可移除某个应用。
构建您自己的连接
Screenbird 提供公开的 API。每次请求时，把您的令牌作为 Bearer 令牌发送。API 的完整说明（包括所有请求以及每个请求所需的权限）见 api.screenbird.app/v1/openapi.json。