[comment]: # translation:outdated

[comment]: # ({8d34cfb0-851ae152})
# 4 API 令牌

[comment]: # ({/8d34cfb0-851ae152})

[comment]: # ({463434e8-7d7a0a5c})
#### 概览

此部分允许创建和管理 API 令牌。

![](../../../../../assets/en/manual/web_interface/api_tokens.png){width="600"}

您可以通过名称、分配令牌的用户、过期日期、创建令牌的用户或状态（启用/禁用）来筛选 API 令牌。在列表中点击令牌状态以快速启用/禁用令牌。您还可以通过在列表中选择令牌，然后点击列表下方的 *启用/禁用* 按钮来批量启用/禁用令牌。

要创建新的令牌，请点击右上角的 *创建 API 令牌* 按钮，然后在令牌配置界面填写必填字段：

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_token_conf.png)

|参数|描述|
|--|--------|
|名称|令牌的可见名称。|
|用户|应分配令牌的用户。要快速选择用户，请开始输入用户名、名字或姓氏，然后从自动完成列表中选择所需用户。或者，您可以点击 *选择* 按钮，从完整的用户列表中选择用户。一个令牌只能分配给一个用户。|
|描述|可选的令牌描述。|
|设置过期日期和时间|如果令牌不应具有过期日期，请取消选中此复选框。|
|过期日期|点击日历图标选择令牌过期日期，或者手动输入格式为 YYYY-MM-DD hh:mm:ss 的日期。|
|启用|如果需要创建一个处于禁用状态的令牌，请取消选中此复选框。|

点击 *添加* 创建令牌。在下一个界面，**在关闭页面前**复制并保存 *Auth token* 值到一个安全的地方，然后点击 *关闭*。令牌将出现在列表中。

::: notewarning
*Auth token* 值创建后无法再次查看。仅在创建令牌后立即可用。如果您丢失了保存的令牌，将需要重新生成，这将创建一个新的授权字符串。
:::

点击令牌名称以编辑名称、描述、过期日期设置或令牌状态。请注意，不允许更改令牌分配给哪个用户。点击 *更新* 按钮保存更改。如果令牌丢失或暴露，可以点击 *重新生成* 按钮生成新的令牌值。将会出现确认对话框，要求确认此操作，因为继续后之前生成的令牌将变为无效。

没有访问 *管理* 菜单部分权限的用户，只能在其 [用户资料 → API 令牌](/manual/web_interface/user_profile#api_tokens) 部分查看和修改分配给他们的令牌详细信息，前提是在其 [用户角色](/manual/web_interface/frontend_sections/users/user_roles) 权限中允许 *管理 API 令牌*。

[comment]: # ({/463434e8-7d7a0a5c})