mirror of
https://github.com/twentyhq/twenty.git
synced 2026-06-12 09:57:03 -04:00
56 lines
2.6 KiB
Plaintext
56 lines
2.6 KiB
Plaintext
---
|
|
title: API
|
|
icon: plug
|
|
description: API REST e GraphQL generate dallo schema del tuo spazio di lavoro.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
## 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 esempio `Invoice`), 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
|
|
|
|
```
|
|
Authorization: Bearer YOUR_API_KEY
|
|
```
|
|
|
|
Crea una chiave API in **Impostazioni → API & Webhooks → + Crea chiave**. Copiala immediatamente — viene mostrata una sola volta. Le chiavi possono essere limitate a un ruolo specifico in **Impostazioni → Ruoli → scheda Assegnazione** per limitare ciò a cui possono accedere.
|
|
|
|
<VimeoEmbed videoId="928786722" title="Creazione della chiave API" />
|
|
|
|
Per l'accesso basato su OAuth (app esterne che agiscono per conto degli utenti), vedi [OAuth](/l/it/developers/extend/oauth).
|
|
|
|
## 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 come `CreateCompanies`.
|
|
|
|
## Limiti di frequenza delle API
|
|
|
|
| Limite | Valore |
|
|
| ---------------- | ---------------------- |
|
|
| Richieste | 100 al minuto |
|
|
| Dimensione batch | 60 record per chiamata |
|