DocsAPI Keys

API Key管理

了解如何创建、管理和保护您的FreeFileTools API Key。

创建API Key

创建API Key的步骤：

  1. 在freefiletools.io登录您的账户
  2. 导航到仪表板 > API Keys
  3. 点击创建API Key
  4. 为密钥添加描述性名称（例如：「我的应用」、「CI流水线」）
  5. 复制并安全存储密钥 -- 密钥只会显示一次

密钥格式如下： fft_abc123def456...

免费套餐

功能限制
每个账户的API Key数量1
每小时请求数50
最大文件大小25 MB
所有端点已包含

重新生成密钥

如果您的API Key泄露或需要新密钥：

  1. 前往仪表板 > API Keys
  2. 点击现有密钥旁边的重新生成按钮
  3. 确认操作 -- 旧密钥将立即失效
  4. 复制并存储新密钥

警告： 重新生成密钥会立即使旧密钥失效。使用旧密钥的应用程序在更新为新密钥之前将停止工作。

安全最佳实践

1.

切勿分享您的API Key

不要在公共代码仓库、论坛或客户端代码中分享密钥。

2.

使用环境变量

将API Key存储在环境变量中，而非源代码中。

3.

保持在服务器端

从后端服务器发起API调用。切勿在前端JavaScript中暴露密钥。

4.

泄露时立即重新生成

如果密钥可能已泄露，请立即从仪表板重新生成。

示例：使用环境变量

bash
# .env file (do NOT commit this)
FFT_API_KEY=fft_your_api_key_here
javascript
// Read from environment variable
const apiKey = process.env.FFT_API_KEY;

const response = await fetch("https://freefiletools.io/api/image-compress", {
  method: "POST",
  headers: {
    "x-api-key": apiKey,
  },
  body: formData,
});