URL base
- Teable Cloud:
https://app.teable.ai - Autoalojado: usa tu propio dominio (por ejemplo,
https://teable.example.com)
/api.
Autenticación
Las API de Teable utilizan tokens Bearer:- Token de acceso personal: ideal para scripts, herramientas internas e integraciones del lado del servidor. Consulta Token de acceso.
- Token de acceso OAuth: ideal para integraciones multiusuario en las que los usuarios finales conceden acceso. Consulta Aplicación OAuth.
IDs (spaceId / baseId / tableId / viewId / fieldId / recordId)
La mayoría de los endpoints requieren IDs comotbl..., rec.... Consulta Obtener IDs.
Ámbitos y permisos
Tanto los tokens de acceso personales como los tokens OAuth están limitados por permisos. Si recibes un 403, normalmente significa que al token le falta el ámbito requerido.- Consulta Códigos de error
- Referencia de ámbitos OAuth: Aplicación OAuth
Paginación (take / skip)
Muchos endpoints de lista admiten:take: número de elementos que se devolverán (algunos endpoints tienen un límite; por ejemplo, 100 Registros por solicitud, por lo que debes paginar conskip)skip: número de elementos que se omitirán
Claves de Campo y formato de celda
Algunas API te permiten controlar cómo se representan los Campos de Registro:fieldKeyType:name(default) /id/dbFieldNamecellFormat:json(default) /text
Adónde ir después
- Solo quieres obtener datos: Obtener Registros
- Crear/actualizar/eliminar Registros: Crear Registros, Actualizar Registro, Eliminar Registros
- Cargar adjuntos: Cargar adjunto
- Lista completa de endpoints: usa la navegación de la izquierda en Referencia de la API