Ruta
GET /api/table/{tableId}/record Solicitud
Parámetros de ruta
tableId (string): El identificador único de la Tabla (cómo obtenerlo).Parámetros de consulta básicos
Todos los parámetros son opcionalesstring
Especifica el ID de la Vista de la que se obtendrán los Registros. Si no se especifica, los Registros se devolverán en orden de creación e incluirán todos los Registros y Campos.
number
Especifica el número de Registros que se recuperarán; el valor máximo es 100. Para leer más Registros, recorre los datos por páginas con
skip y take (consulta Paginación).El límite de 100 Registros se aplica a las claves de API personales de Teable Cloud creadas a partir del 10 de septiembre de 2026. Las claves creadas antes de esa fecha, los tokens de OAuth y de complementos, y las instancias autoalojadas siguen admitiendo hasta 1000, pero el tamaño de página recomendado continúa siendo de 100.number
Especifica el número de Registros que se omitirán; se utiliza para la paginación.
string
predeterminado:"name"
Define el tipo de clave de los Campos de los Registros; los valores posibles son:
name: Usa los nombres de los Campos como claves (valor predeterminado)id: Usa los ID de los Campos como clavesdbFieldName: Usa los dbFieldName de los Campos como claves
string
predeterminado:"json"
Define el formato de devolución de los valores de celda; los valores posibles son:
json: Devuelve datos JSON estructurados (valor predeterminado)text: Devuelve un formato de texto sin formato
string[]
Si solo necesitas Campos concretos, especifícalos mediante este parámetro. De lo contrario, se recuperarán todos los Campos visibles. Los valores del parámetro dependen de la configuración de fieldKeyType (se usan nombres de Campos, ID o dbFieldName).
string
Matriz de objetos de ordenación que especifican cómo deben ordenarse los Registros.
string
Objeto de condiciones de consulta complejas para filtrar los resultados. Admite condiciones de consulta complejas basadas en Campos, operadores y valores.
string[]
Busca Registros que coincidan con los Campos y valores especificados.
Parámetros de consulta avanzados
Parámetros de consulta avanzados
string
Matriz de objetos de agrupación que especifican cómo deben agruparse los Registros.
string[]
Matriz de ID de grupos que se contraerán.
string[]
Filtra los Registros seleccionados por sus ID de Registro.
boolean
Cuando se especifica viewId, establecer este valor en true hará que se ignoren los filtros, la ordenación y los demás ajustes de la Vista.
string[]
Filtra los Registros de la Tabla enlazada que puede seleccionar la celda de enlace especificada. Por ejemplo, en los Campos de relación uno a varios o uno a uno, no aparecerán los ID de Registro ya seleccionados.
string[]
Filtra los Registros de la Tabla enlazada que ya están seleccionados por esta celda de enlace. Nota: viewId, filter y orderBy no surtirán efecto en este caso, ya que los Registros seleccionados tienen su propio orden.