Airtable

简介

Airtable API 把你的 Airtable Base 变成 RESTful 数据存储——在表中列出、创建、更新和删除记录，管理字段，在类表格数据库之上构建应用。认证是个人访问令牌（或旧版 API 密钥）。

快速开始

需要个人访问令牌（在 airtable.com/create/tokens 创建）：

# 列出表中的记录：
curl "https://api.airtable.com/v0/BASE_ID/TABLE_NAME" \
  -H "Authorization: Bearer YOUR_TOKEN"

带筛选和分页：

curl "https://api.airtable.com/v0/BASE_ID/TABLE_NAME?filterByFormula=NOT({Status}%3D'Done')&pageSize=100" \
  -H "Authorization: Bearer YOUR_TOKEN"

创建记录：

curl -X POST "https://api.airtable.com/v0/BASE_ID/TABLE_NAME" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"Name": "New item", "Status": "Todo"}}'

更新记录：

curl -X PATCH "https://api.airtable.com/v0/BASE_ID/TABLE_NAME/RECORD_ID" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"Status": "Done"}}'

认证方式

• 在 airtable.com/create/tokens 创建个人访问令牌（按 Base 限定 scope）。
• 通过 Authorization: Bearer YOUR_TOKEN 发送。
• Base ID 在你的 Base 的 API 文档里（https://airtable.com/{baseId}/api）。

速率限制与注意事项

• 速率限制：每个 Base 5 次请求/秒（带认证/缓存的应用可更高）。
• 超过 1,000 条记录的 Base 需要分页（响应中的 offset 参数）。
• filterByFormula 使用 Airtable 公式语法（需要 URL 编码）。
• 元数据 API（/v0/meta/bases）列出你的 Base 和 schema。

常见问题

Airtable API 免费吗？ 是的——任何套餐下 API 都在速率限制内免费。

如何获取令牌？ airtable.com/create/tokens → 创建限定 scope 的个人访问令牌。

如何筛选记录？ filterByFormula=... 用 URL 编码的 Airtable 公式语法。