Percorso
GET /api/table/{tableId}/record Richiesta
Parametri del percorso
tableId (string): identificatore univoco della Tabella (come ottenerlo).Parametri di query di base
Tutti i parametri sono facoltativi.string
Specifica l’ID della Vista da cui recuperare i Record. Se non viene specificato, i Record vengono restituiti in ordine di creazione, includendo tutti i Record e i Campi.
number
Specifica il numero di Record da recuperare; il valore massimo è 100. Per leggere più Record, suddividi i dati in pagine usando
skip e take (consulta Paginazione).Il limite di 100 Record si applica alle chiavi API personali di Teable Cloud create a partire dal 10 settembre 2026. Le chiavi create prima di tale data, i token OAuth e dei plugin e le istanze self-hosted accettano ancora fino a 1000 Record, ma la dimensione consigliata per pagina rimane 100.number
Specifica il numero di Record da ignorare e viene utilizzato per la paginazione.
string
predefinito:"name"
Definisce il tipo di chiave dei Campi nei Record; i valori possibili sono:
name: usa i nomi dei Campi come chiavi (predefinito)id: usa gli ID dei Campi come chiavidbFieldName: usa il dbFieldName dei Campi come chiavi
string
predefinito:"json"
Definisce il formato restituito per i valori delle celle; i valori possibili sono:
json: restituisce dati JSON strutturati (predefinito)text: restituisce il formato di testo normale
string[]
Se ti servono soltanto Campi specifici, indicali tramite questo parametro. In caso contrario, verranno recuperati tutti i Campi visibili. I valori del parametro dipendono dall’impostazione fieldKeyType (nomi dei Campi, ID o dbFieldName).
string
Array di oggetti di ordinamento che specificano come ordinare i Record.
string
Oggetto con condizioni di query complesse per filtrare i risultati. Supporta condizioni di query complesse basate su Campi, operatori e valori.
string[]
Cerca i Record che corrispondono ai Campi e ai valori specificati.
Parametri di query avanzati
Parametri di query avanzati
string
Array di oggetti di raggruppamento che specificano come raggruppare i Record.
string[]
Array degli ID dei gruppi da comprimere.
string[]
Filtra i Record selezionati in base ai relativi ID.
boolean
Quando viewId è specificato, impostando questo parametro su true verranno ignorati i filtri, l’ordinamento e le altre impostazioni della Vista.
string[]
Filtra i Record della Tabella collegata che possono essere selezionati dalla cella di collegamento specificata. Ad esempio, per i Campi con relazione uno-a-molti o uno-a-uno, gli ID dei Record già selezionati non verranno visualizzati.
string[]
Filtra i Record della Tabella collegata già selezionati da questa cella di collegamento. Nota: in questo caso viewId, filter e orderBy non avranno effetto, poiché i Record selezionati dispongono di un proprio ordine.