Путь
GET /api/table/{tableId}/record Запрос
Параметры пути
tableId (string): Уникальный идентификатор Таблицы (как получить).Основные параметры запроса
Все параметры необязательныstring
Определяет ID Представления, из которого нужно получить Записи. Если параметр не указан, Записи будут возвращены в порядке времени создания, включая все Записи и Поля.
number
Определяет количество извлекаемых Записей; максимальное значение — 100. Чтобы прочитать больше Записей, разбивайте данные на страницы с помощью
skip и take (см. Разбиение на страницы).Ограничение в 100 Записей применяется к персональным ключам API Teable Cloud, созданным 10 сентября 2026 года или позднее. Ключи, созданные до этой даты, токены OAuth и плагинов, а также экземпляры с самостоятельным размещением по-прежнему принимают до 1000, однако рекомендуемый размер страницы — 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 не действуют, так как выбранные Записи имеют собственный порядок.