Этот раздел поможет быстро и безопасно начать работу с API Teable.
Базовый URL
- Teable Cloud:
https://app.teable.ai
- Самостоятельное размещение: используйте собственный домен (например,
https://teable.example.com)
Все пути API в этой документации являются относительными относительно базового URL и начинаются с /api.
Аутентификация
API Teable используют Bearer-токены:
Можно использовать один из следующих вариантов:
- Персональный токен доступа: оптимален для скриптов, внутренних инструментов и серверных интеграций. См. токен доступа.
- Токен доступа OAuth: оптимален для мультитенантных интеграций, в которых конечные пользователи предоставляют доступ. См. OAuth-приложение.
ID (spaceId / baseId / tableId / viewId / fieldId / recordId)
Для большинства конечных точек требуются ID, такие как tbl..., rec.... См. Получение ID.
Области действия и разрешения
Как персональные токены доступа, так и токены OAuth ограничены разрешениями. Если вы получаете ошибку 403, обычно это означает, что у токена отсутствует необходимая область действия.
Разбиение на страницы (take / skip)
Многие конечные точки списков поддерживают:
take: количество возвращаемых элементов (для некоторых конечных точек действует ограничение; например, максимум 100 Записей на запрос, поэтому используйте skip для разбиения на страницы)skip: количество пропускаемых элементов
Ключи Полей и формат ячеек
Некоторые API позволяют управлять представлением Полей Записи:
fieldKeyType: name (по умолчанию) / id / dbFieldNamecellFormat: json (по умолчанию) / text
Структуры значений Полей Записи см. в разделе Интерфейс Поля Записи.
Что дальше
Последнее изменение 4 сентября 2026 г.
