账户令牌

账户令牌提供了一种简单方式，用于认证 API 请求，无需经过完整的 OAuth 流程。它们非常适合脚本、CI/CD 流水线和个人自动化。

创建令牌

1. 登录 Glossia 并导航至您的账户仪表板。
2. 打开 API 侧边栏中的部分。
3. 点击 账户令牌然后 新令牌.
4. 为令牌指定一个描述性的 名称 (例如，"CI deploy"或"CLI access")。
5. 选择 作用域 该令牌所需的。仅授予所需的最低权限。
6. 设置一个 过期日期 或留空以创建永不过期的令牌。
7. 点击 创建令牌。

创建后，将显示完整的令牌值 仅一次. 请立即复制并安全存储。您之后将无法再次看到完整值。

使用令牌

请将令牌包含在 Authorization HTTP 请求标头中：

Authorization: Bearer glsa_abc123def456...

例如，使用 curl:

curl -H "Authorization: Bearer glsa_abc123def456..." \
  https://glossia.ai/api/projects

账户令牌遵循相同 授权模型 作为 OAuth 令牌。令牌的作用域定义了其可执行的最大操作集，且资源级别的策略仍会根据您账户的关系适用。

令牌格式

所有账户令牌均以 glsa_ 前缀后跟随机十六进制字符串。此前缀可让您在日志和秘密扫描器中轻松识别 Glossia 令牌。

作用域

账户令牌支持与 OAuth 令牌相同的作用域。查看 作用域参考 完整列表。

创建令牌时，仅选择您用例所需的范围。例如：

• 只读集成需要 project:read 和 voice:read.
• 创建项目的 CI 流水线需要 project:read 和 project:write.
• 管理组织成员的脚本需要 members:read 和 members:write。

管理令牌

查看令牌

该 账户令牌 页面列出所有活动令牌及其名称、作用域、最后使用的日期和到期时间。从未使用过的令牌在“最后使用”列中显示"Never"。

编辑令牌

点击令牌名称以编辑其 名称 和 描述. 作用域和过期时间无法在创建后更改。如需不同的作用域，请创建新令牌并撤销旧令牌。

撤销令牌

要撤销令牌，点击 撤销 在令牌列表中，或打开令牌的编辑页面并使用 撤销令牌 按钮在危险区域。已撤销的令牌会立即停止工作且无法恢复。

安全最佳实践

• 安全存储令牌。 使用环境变量或密钥管理器。切勿将令牌提交至源代码控制。
• 使用短效令牌。 在可能的情况下设置过期日期。
• 最小化作用域。 仅授予令牌实际需要的权限。
• 定期轮换。 按计划创建新令牌并撤销旧令牌。
• 监控使用情况。 定期检查"最后使用"日期。撤销不再使用的令牌。
• 每个集成使用一个令牌。 这样，撤销一个令牌不会影响其他工作流程。

API 管理

您还可以通过 REST API 和 MCP 服务器管理账户令牌。

REST API

MCP

MCP 服务器提供 list_tokens, create_token，以及 revoke_token 镜像 REST API 的工具。