> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取 API Key

> 在 Qoder 控制台为组织创建 Teams OpenAPI 访问密钥的操作步骤。

组织 **管理员** 可在 Web 控制台创建用于调用 OpenAPI 的 **API Key**。密钥创建后即具备与创建人相当的 API 访问能力（在产品权限模型允许范围内），请按需创建并限制知晓范围。

## 前置条件

* 使用具备 **组织管理员** 权限的账号登录 Qoder。
* 已打开目标组织的 **设置** 页面。

## 操作步骤

1. 在浏览器中打开组织设置（将 `{orgid}` 替换为实际组织 ID）：

   `https://qoder.com/organizations/{orgid}/settings`

2. 在左侧导航选择 **「设置」**，进入 **「高级」** 区域，找到 **「API 密钥」**。

3. 单击 **「新建 API 密钥」**。

4. 在对话框中填写 **密钥名称**、**过期时间**，单击 **创建**。

5. **立即复制** 界面中展示的密钥字符串，并勾选 **「我已安全保存此 API Key」** 完成流程。

## 界面示意

以下为控制台相关界面截图，便于对照操作步骤（若与线上界面略有差异，以实际产品为准）。

<img src="https://mintcdn.com/qoder/-L3W3SOTn14gUoWt/images/teams-openapi-api-key-01.png?fit=max&auto=format&n=-L3W3SOTn14gUoWt&q=85&s=7e5ca4264577d58207cb3e495675328b" alt="组织设置中的高级与 API 密钥入口" width="3010" height="1510" data-path="images/teams-openapi-api-key-01.png" />

<img src="https://mintcdn.com/qoder/-L3W3SOTn14gUoWt/images/teams-openapi-api-key-02.png?fit=max&auto=format&n=-L3W3SOTn14gUoWt&q=85&s=b8c81e6b4cc0663e9626341ee116c5a4" alt="新建 API 密钥对话框" width="3014" height="1526" data-path="images/teams-openapi-api-key-02.png" />

<img src="https://mintcdn.com/qoder/-L3W3SOTn14gUoWt/images/teams-openapi-api-key-03.png?fit=max&auto=format&n=-L3W3SOTn14gUoWt&q=85&s=baac47ae1505181422ed0619958a205a" alt="创建完成与密钥展示（请立即保存）" width="1886" height="948" data-path="images/teams-openapi-api-key-03.png" />

<Warning>
  密钥 **仅在创建时完整展示一次**。关闭窗口后将无法再次查看明文，遗失需 **作废并新建**。
</Warning>

## 表单字段说明

| 字段   | 说明                                         |
| ---- | ------------------------------------------ |
| 密钥名称 | 自定义名称，便于在列表中区分用途；长度上限以控制台为准（通常不超过 100 字符）。 |
| 过期时间 | 可选择最长约 **1 年** 内的到期时间；到期后密钥自动失效，无法继续调用接口。  |

## 创建后建议

* 在集成环境中使用 **环境变量** 或密钥管理服务存储 Key，勿硬编码。
* 为不同系统或环境分别创建密钥，便于 **单独吊销**。
* 详细安全要求见 **[API Key 安全](/zh/account/teams/openapi/api-key-security)**。