Pfad
GET /api/table/{tableId}/record Anfrage
Pfadparameter
tableId (string): Die eindeutige Kennung der Tabelle (so erhalten Sie sie).Grundlegende Abfrageparameter
Alle Parameter sind optionalstring
Gibt die Ansichts-ID an, aus der Datensätze abgerufen werden sollen. Wenn keine angegeben ist, werden Datensätze in der Reihenfolge ihrer Erstellungszeit zurückgegeben, einschließlich aller Datensätze und Felder.
number
Gibt die Anzahl der abzurufenden Datensätze an; der Höchstwert beträgt 100. Um weitere Datensätze zu lesen, paginieren Sie die Daten mit
skip und take (siehe Paginierung).Die Begrenzung auf 100 Datensätze gilt für persönliche Teable-Cloud-API-Schlüssel, die am oder nach dem 10. September 2026 erstellt wurden. Vor diesem Datum erstellte Schlüssel, OAuth- und Plugin-Tokens sowie selbstgehostete Instanzen akzeptieren weiterhin bis zu 1000, wobei Seiten mit 100 Einträgen die empfohlene Größe bleiben.number
Gibt die Anzahl der zu überspringenden Datensätze an und wird für die Paginierung verwendet.
string
Standard:"name"
Definiert den Schlüsseltyp für Felder in Datensätzen; mögliche Werte:
name: Feldnamen als Schlüssel verwenden (Standard)id: Feld-IDs als Schlüssel verwendendbFieldName: dbFieldName des Feldes als Schlüssel verwenden
string
Standard:"json"
Definiert das Rückgabeformat für Zellenwerte; mögliche Werte:
json: Gibt strukturierte JSON-Daten zurück (Standard)text: Gibt das Nur-Text-Format zurück
string[]
Wenn Sie nur bestimmte Felder benötigen, geben Sie sie über diesen Parameter an. Andernfalls werden alle sichtbaren Felder abgerufen. Die Parameterwerte hängen von der fieldKeyType-Einstellung ab (Feldnamen, IDs oder dbFieldName verwenden).
string
Array von Sortierobjekten, das festlegt, wie Datensätze sortiert werden sollen.
string
Komplexes Abfragebedingungsobjekt zum Filtern von Ergebnissen. Unterstützt komplexe Abfragebedingungen auf Grundlage von Feldern, Operatoren und Werten.
string[]
Sucht nach Datensätzen, die den angegebenen Feldern und Werten entsprechen.
Erweiterte Abfrageparameter
Erweiterte Abfrageparameter
string
Array von Gruppenobjekten, das festlegt, wie Datensätze gruppiert werden sollen.
string[]
Array der einzuklappenden Gruppen-IDs.
string[]
Filtert ausgewählte Datensätze nach Datensatz-IDs.
boolean
Wenn viewId angegeben ist, werden durch die Einstellung auf true die Filter, die Sortierung und andere Einstellungen der Ansicht ignoriert.
string[]
Filtert Datensätze aus der verknüpften Tabelle, die über die angegebene Verknüpfungszelle ausgewählt werden können. Beispielsweise werden bei Eins-zu-viele- oder Eins-zu-eins-Beziehungsfeldern bereits ausgewählte Datensatz-IDs nicht angezeigt.
string[]
Filtert Datensätze aus der verknüpften Tabelle, die bereits durch diese Verknüpfungszelle ausgewählt sind. Hinweis: viewId, filter und orderBy haben in diesem Fall keine Wirkung, da ausgewählte Datensätze ihre eigene Reihenfolge haben.