パス
GET /api/table/{tableId}/record リクエスト
パスパラメーター
tableId (string): テーブルの一意の識別子です(取得方法)。基本クエリパラメーター
すべてのパラメーターは任意です。string
レコードを取得するビューIDを指定します。指定しない場合は、すべてのレコードとフィールドが作成日時順に返されます。
number
取得するレコード数を指定します。最大値は100です。さらに多くのレコードを読み取るには、
skipとtakeを使用してデータをページ分割してください(ページネーションを参照)。100レコードの上限は、2026年9月10日以降に作成されたTeable CloudのパーソナルAPIキーに適用されます。それ以前に作成されたキー、OAuthトークン、プラグイントークン、セルフホストインスタンスでは引き続き最大1000件まで取得できますが、1ページ100件を推奨します。number
ページネーションでスキップするレコード数を指定します。
string
デフォルト:"name"
レコード内のフィールドに使用するキーの種類を定義します。指定できる値は次のとおりです。
name: フィールド名をキーとして使用します(デフォルト)id: フィールドIDをキーとして使用しますdbFieldName: フィールドのdbFieldNameをキーとして使用します
string
デフォルト:"json"
セル値の返却形式を定義します。指定できる値は次のとおりです。
json: 構造化されたJSONデータを返します(デフォルト)text: プレーンテキスト形式で返します
string[]
特定のフィールドだけが必要な場合は、このパラメーターで指定します。指定しない場合は、表示されているすべてのフィールドを取得します。パラメーターの値はfieldKeyTypeの設定によって異なります(フィールド名、ID、またはdbFieldNameを使用します)。
string
レコードの並び順を指定するソートオブジェクトの配列です。
string
結果を絞り込むための複合クエリ条件オブジェクトです。フィールド、演算子、値に基づく複合クエリ条件を使用できます。
string[]
指定したフィールドと値に一致するレコードを検索します。
高度なクエリパラメーター
高度なクエリパラメーター
string
レコードのグループ化方法を指定するグループオブジェクトの配列です。
string[]
折りたたむグループIDの配列です。
string[]
レコードIDを使用して、選択したレコードを絞り込みます。
boolean
viewIdを指定したとき、この値をtrueに設定すると、ビューのフィルター、並べ替え、その他の設定を無視します。
string[]
指定したリンクセルで選択できるリンク先テーブルのレコードを絞り込みます。たとえば、一対多または一対一のリレーションフィールドでは、すでに選択されているレコードIDは表示されません。
string[]
このリンクセルですでに選択されているリンク先テーブルのレコードを絞り込みます。この場合、選択済みレコードには独自の順序があるため、viewId、filter、orderByは適用されません。

