Questa sezione ti aiuta a iniziare a utilizzare l’API di Teable in modo rapido e sicuro.
URL di base
- Teable Cloud:
https://app.teable.ai
- Self-hosted: usa il tuo dominio (ad esempio
https://teable.example.com)
Tutti i percorsi API presenti in questa documentazione sono relativi all’URL di base e iniziano con /api.
Autenticazione
Le API di Teable utilizzano token Bearer:
Puoi utilizzare:
- Token di accesso personale: ideale per script, strumenti interni e integrazioni lato server. Consulta Token di accesso.
- Token di accesso OAuth: ideale per integrazioni multi-tenant in cui gli utenti finali concedono l’accesso. Consulta App OAuth.
ID (spaceId / baseId / tableId / viewId / fieldId / recordId)
La maggior parte degli endpoint richiede ID come tbl..., rec.... Consulta Ottenere gli ID.
Ambiti e autorizzazioni
Sia i token di accesso personali sia i token OAuth dispongono di ambiti di autorizzazione. Se ricevi un errore 403, in genere al token manca l’ambito richiesto.
Paginazione (take / skip)
Molti endpoint di elenco supportano:
take: numero di elementi da restituire (alcuni endpoint applicano un limite; ad esempio, per i Record il massimo è 100 per richiesta, quindi usa skip per suddividere i risultati in pagine)skip: numero di elementi da ignorare
Alcune API consentono di controllare il modo in cui vengono rappresentati i Campi dei Record:
fieldKeyType: name (predefinito) / id / dbFieldNamecellFormat: json (predefinito) / text
Per le strutture dei valori dei Campi dei Record, consulta Interfaccia dei Campi dei Record.
Passaggi successivi
Ultima modifica il 4 settembre 2026
