Airtable 凭据#

你可以使用这些凭据来认证以下节点：

• Airtable
• Airtable Trigger

前提条件#

创建一个 Airtable 账户。

支持的认证方式#

• 个人访问令牌（Personal Access Token, PAT）
• OAuth2

API 密钥弃用说明 n8n 曾支持使用 API 密钥对 Airtable 进行认证。但 Airtable 已于 2024 年 2 月全面弃用此类密钥。如果你之前使用的是 Airtable API 凭据，请将其替换为 Airtable 个人访问令牌（PAT）或 Airtable OAuth2 凭据。n8n 推荐优先使用个人访问令牌（PAT）。

相关资源#

更多服务信息，请参考 Airtable 的 API 文档。

使用个人访问令牌（PAT）#

要配置此凭据，你需要：

• 一个个人访问令牌（Access Token, PAT）

创建你的 PAT 的步骤如下：

1. 访问 Airtable Builder Hub 的 个人访问令牌 页面。
2. 点击 + 创建新令牌。Airtable 将打开 创建个人访问令牌 页面。
3. 为你的令牌输入一个名称，例如 n8n credential。
4. 为令牌添加作用域（Scopes）。更多信息请参考 Airtable 的 Scopes 文档。n8n 推荐使用以下作用域：
   • data.records:read
   • data.records:write
   • schema.bases:read
5. 设置令牌的访问权限（Access）。你可以选择单个 base、多个 base（甚至来自不同工作区的 base）、你拥有的某个工作区中当前和未来的所有 base，或你拥有的任意工作区中的所有 base（包括将来新增的 base/工作区）。
6. 点击 创建令牌（Create token）。
7. Airtable 将弹出一个包含你令牌的对话框。复制该令牌，并在 n8n 凭据中将其填入为 Access Token 字段。

更多信息，请参考 Airtable 的 查找/创建 PAT 文档。

使用 OAuth2#

要配置此凭据，你需要：

• 一个 OAuth 重定向 URL（OAuth Redirect URL）
• 一个 客户端 ID（Client ID）
• 一个 客户端密钥（Client Secret）

要生成所有这些信息，请注册一个新的 Airtable 集成：

1. 打开你的 Airtable Builder Hub 的 OAuth 集成页面。

2. 选择 Register new OAuth integration（注册新的 OAuth 集成）按钮。

3. 为你的 OAuth 集成输入一个名称。

4. 从你的 n8n 凭据中复制 OAuth Redirect URL（OAuth 重定向 URL）。

5. 将该重定向 URL 粘贴到 Airtable 中作为 OAuth redirect URL（OAuth 重定向 URL）。

6. 选择 Register integration（注册集成）。

7. 在接下来的页面中，复制 Airtable 中的 Client ID（客户端 ID），并将其粘贴到你的 n8n 凭据中的 Client ID 字段。

8. 在 Airtable 中，选择 Generate client secret（生成客户端密钥）。

9. 复制生成的客户端密钥，并将其粘贴到 n8n 凭据中的 Client Secret（客户端密钥）字段。

10. 在 Airtable 中选择以下权限范围（scopes）：

    • data.records:read
    • data.records:write
    • schema.bases:read

11. 选择 Save changes（保存更改）以完成设置。

12. 在你的 n8n 凭据中，选择 Connect my account（连接我的账户）。此时会弹出一个 Grant access（授权访问）对话框。

13. 按照提示操作，并选择你想要操作的 base（数据库），或选择所有 bases。

14. 选择 Grant access（授权访问）以完成连接。

有关注册新 OAuth 集成的详细步骤，请参考 Airtable 注册新集成文档。