API con schema per tenant
Non esiste un riferimento API statico per Twenty. Ogni spazio di lavoro ha il proprio schema — quando aggiungi un oggetto personalizzato (ad esempioInvoice), ottiene immediatamente endpoint REST e GraphQL identici a quelli degli oggetti integrati come Company o Person. L’API è generata dallo schema, quindi gli endpoint usano direttamente i nomi dei tuoi oggetti e campi — niente ID opachi.
La documentazione delle API specifica del tuo spazio di lavoro è disponibile in Impostazioni → API & Webhooks dopo aver creato una chiave API. Include un playground interattivo in cui puoi eseguire chiamate reali sui tuoi dati.
Due API
API principale —/rest/ e /graphql/
CRUD sui record: Persone, Aziende, Opportunità, i tuoi oggetti personalizzati. Esegui query, filtra, attraversa le relazioni.
API dei metadati — /rest/metadata/ e /metadata/
Gestione dello schema: crea/modifica/elimina oggetti, campi e relazioni. Questo è il modo per modificare in modo programmatico il tuo modello di dati.
Entrambe sono disponibili in REST e GraphQL. GraphQL aggiunge upsert in batch e la possibilità di attraversare le relazioni in un’unica query. I dati sottostanti sono gli stessi in entrambi i casi.
URL di base
| Ambiente | URL di base |
|---|---|
| Cloud | https://api.twenty.com/ |
| Auto-ospitato | https://{your-domain}/ |
Autenticazione
Operazioni batch
Sia REST che GraphQL supportano il batching fino a 60 record per richiesta — creazione, aggiornamento o eliminazione. GraphQL supporta anche l’upsert in batch (crea o aggiorna in una sola chiamata) usando nomi plurali comeCreateCompanies.
Limiti di frequenza delle API
| Limite | Valore |
|---|---|
| Richieste | 100 al minuto |
| Dimensione batch | 60 record per chiamata |