Шлях
GET /api/table/{tableId}/record Запит
Параметри шляху
tableId (string): Унікальний ідентифікатор Таблиці (як знайти).Основні параметри запиту
Усі параметри необов’язковіstring
Визначає ідентифікатор Перегляду, з якого потрібно отримати Записи. Якщо його не вказано, Записи повертаються в порядку часу створення, разом з усіма Записами та Полями.
number
Визначає кількість Записів, які потрібно отримати; максимальне значення — 100. Щоб прочитати більше Записів, переходьте між сторінками даних за допомогою
skip і take (див. Пагінація).Обмеження у 100 Записів застосовується до персональних ключів API Teable Cloud, створених 10 вересня 2026 року або пізніше. Ключі, створені до цієї дати, токени OAuth і плагінів, а також самостійно розгорнуті екземпляри й надалі підтримують до 1000 Записів, однак рекомендований розмір сторінки становить 100 Записів.number
Визначає кількість Записів, які потрібно пропустити; використовується для пагінації.
string
за замовчуванням:"name"
Визначає тип ключів Полів у Записах. Можливі значення:
name: використовувати назви Полів як ключі (за замовчуванням)id: використовувати ідентифікатори Полів як ключіdbFieldName: використовувати значення dbFieldName Полів як ключі
string
за замовчуванням:"json"
Визначає формат повернення значень комірок. Можливі значення:
json: повертає структуровані дані JSON (за замовчуванням)text: повертає дані у форматі звичайного тексту
string[]
Якщо потрібні лише певні Поля, укажіть їх у цьому параметрі. Інакше буде отримано всі видимі Поля. Значення параметра залежать від налаштування fieldKeyType (використовуються назви Полів, їхні ідентифікатори або dbFieldName).
string
Масив об’єктів сортування, що визначають порядок Записів.
string
Об’єкт складної умови запиту для фільтрування результатів. Підтримує складні умови запиту на основі Полів, операторів і значень.
string[]
Пошук Записів, що відповідають указаним Полям і значенням.
Розширені параметри запиту
Розширені параметри запиту
string
Масив об’єктів групування, що визначають спосіб групування Записів.
string[]
Масив ідентифікаторів груп, які потрібно згорнути.
string[]
Фільтрує вибрані Записи за їхніми ідентифікаторами.
boolean
Якщо вказано viewId, установлення цього параметра в значення true призведе до ігнорування фільтрів, сортування та інших налаштувань Перегляду.
string[]
Фільтрує Записи з пов’язаної Таблиці, які можна вибрати за допомогою вказаної комірки зв’язку. Наприклад, для Полів зі зв’язком «один до багатьох» або «один до одного» вже вибрані ідентифікатори Записів не відображатимуться.
string[]
Фільтрує Записи з пов’язаної Таблиці, які вже вибрано за допомогою цієї комірки зв’язку. Примітка: у цьому випадку viewId, filter і orderBy не діятимуть, оскільки вибрані Записи мають власний порядок.