Teable 使用指南
如何安全连接 Teable API
根据官方文档选择 Base URL、使用 Bearer 令牌认证、查找 ID、分页并测试一次有边界的读取。
2026/9/2 Teable Guide Editorial Team 最后更新: 2026/9/2
简短回答： Teable API 通过 HTTP 访问 Base、表、视图和记录。Cloud 基础地址是 https://app.teable.ai，自托管使用自己的域名。
What：API 里有什么
API 使用 spaceId、baseId、tableId、viewId、fieldId 和 recordId 定位资源。列表接口常见 take/skip 分页。不要猜 ID，应从官方响应或 URL 复制。
Why：为什么要限制权限
Personal Access Token 适合内部脚本，OAuth 适合让不同用户分别授权。401 通常是令牌无效，403 是权限不足，404 或空结果常见于 URL/ID 错误。令牌不要写入仓库，也不要一次读取全部记录。
How：第一次安全请求
- 确认 Cloud 或自托管地址。
- 用临时 Base 创建最小只读权限令牌。
- 按官方示例取得 Base 和表 ID。
- 使用
Authorization: Bearer <token>发起带小take的读取。 - 确认返回的 Base/表正确后，再增加分页、写入或附件操作；日志不得包含令牌或敏感记录。
路由和字段以官方 API 文档为准。
api developers integration