Skip to main content
このセクションでは、Teable APIをすばやく安全に使い始める方法を説明します。

ベースURL

  • Teable Cloud: https://app.teable.ai
  • セルフホスト: 独自ドメインを使用します(例: https://teable.example.com
このドキュメント内のすべてのAPIパスはベースURLからの相対パスであり、/apiで始まります。

認証

Teable APIではBearerトークンを使用します。
次のいずれかを使用できます。
  • パーソナルアクセストークン: スクリプト、社内ツール、サーバーサイド連携に最適です。アクセストークンをご覧ください。
  • OAuthアクセストークン: エンドユーザーがアクセスを許可するマルチテナント連携に最適です。OAuthアプリをご覧ください。

ID(spaceId / baseId / tableId / viewId / fieldId / recordId)

ほとんどのエンドポイントでは、tbl...rec...などのIDが必要です。IDの取得をご覧ください。

スコープと権限

パーソナルアクセストークンとOAuthトークンには、いずれも権限スコープが設定されています。403エラーが発生した場合は、通常、トークンに必要なスコープがありません。

ページネーション(take / skip)

多くの一覧取得エンドポイントでは、次のパラメーターを使用できます。
  • take: 返す項目数(一部のエンドポイントには上限があります。たとえばレコードは1リクエストあたり最大100件のため、skipを使用してページを切り替えます)
  • skip: スキップする項目数

フィールドキーとセル形式

一部のAPIでは、レコードのフィールドをどのように表現するかを指定できます。
  • fieldKeyType: name(デフォルト)/ id / dbFieldName
  • cellFormat: json(デフォルト)/ text
レコードのフィールド値の構造については、レコードフィールドインターフェースをご覧ください。

次に読むページ

最終更新日 2026年9月4日