> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/zh/tools/api-integration.md).

# 自定义 API 集成

API 调用工具可以让 Crew 连接任何提供 REST API 的外部服务。这是 Crew 最灵活的工具——只要一个服务有 API，你就能连接它。

## 工作原理

1. 在设置中**存储你的 API 凭证**
2. 用自然语言**让 Crew 调用 API**
3. Crew 构建 API 请求并返回结果

## 配置凭证

使用外部 API 前，先存储你的 API Key：

1. 进入**设置**
2. 滚动到 **API 凭证**（或在安装需要凭证的技能市场技能时配置）
3. 添加凭证：
   * **Key 名称**：一个标签，如 `MY_SERVICE_API_KEY`
   * **值**：你的实际 API Key

凭证经加密安全存储。Crew 调用 API 时，通过 `{{KEY_NAME}}` 占位符注入凭证——实际密钥永远不会在对话中暴露。

## 调用 API

### 简单 GET 请求

> "调用 JSONPlaceholder API 获取前5条帖子：GET <https://jsonplaceholder.typicode.com/posts?\\_limit=5>"

### 带认证的请求

> "用我的 API Key 查一下 Airtable 的数据：GET <https://api.airtable.com/v0/appXXXXX/Table1，Header> 用 Authorization: Bearer {{AIRTABLE\_API\_KEY}}"

### POST 请求

> "在项目管理工具中创建一个新任务：POST <https://api.example.com/tasks，Body> 是 { "title": "审核方案", "priority": "high" }"

## 支持的 HTTP 方法

* **GET** — 获取数据
* **POST** — 创建新资源
* **PUT** — 替换现有资源
* **PATCH** — 部分更新资源
* **DELETE** — 删除资源

## 响应类型

* **JSON** — 结构化数据（默认）
* **Text** — 纯文本响应
* **Binary** — 文件下载

## 超时

* 默认：30 秒
* 最大：120 秒

## 实用示例

### Airtable 集成

> "用我的 Airtable API Key 列出'项目'表中的所有记录，总结每个项目的状态。"

### Slack Webhook

> "用这个 Webhook URL 给团队的 Slack 频道发一条消息：\[webhook URL]。内容：'周报已准备好。'"

### 自定义 CRM

> "用我的 CRM API Key 查看最新的商机：GET <https://api.ourcrm.com/deals?status=open>"

### 天气服务

> "用 OpenWeatherMap API 获取上海未来5天的天气预报。"

### 组合 API

> "用金融 API 查看股票价格，然后通过 Webhook 把结果发到我们的 Slack 频道。"

## 套餐限制

| 套餐    | 技能市场工具（含 API 工具） |
| ----- | ---------------- |
| Free  | 1                |
| Basic | 5                |
| Plus  | 15               |
| Pro   | 无限制              |

## 安全性

* 凭证以 AES-256-GCM 加密存储
* API Key 永远不会在对话回复中显示
* `{{KEY_NAME}}` 占位符机制确保密钥只在执行时注入
* 你可以随时在设置中删除已存储的凭证

## 小贴士

* **从简单开始**：先用一个基本的 GET 请求测试，再构建复杂工作流
* **查看 API 文档**：确认你知道接口格式和必需的 Header
* **搭配定时任务**：将 API 调用和定时任务结合，实现自动化监控
* **链式调用**：可以让 Crew 依次调用多个 API——例如"从 API A 获取数据，处理后发送到 API B"
