i18n - docs translations (#19925)
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
15938c1fca
commit
cd73088be6
@@ -1,147 +1,55 @@
|
||||
---
|
||||
title: API
|
||||
description: Interroga e modifica i dati del tuo CRM in modo programmatico usando REST o GraphQL.
|
||||
icon: plug
|
||||
description: REST and GraphQL APIs generated from your workspace schema.
|
||||
---
|
||||
|
||||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||||
|
||||
Twenty è stato progettato per essere adatto agli sviluppatori, offrendo potenti API che si adattano al tuo modello di dati personalizzato. Forniamo quattro tipi distinti di API per soddisfare diverse esigenze di integrazione.
|
||||
## Schema-per-tenant APIs
|
||||
|
||||
## Approccio incentrato sullo sviluppatore
|
||||
There is no static API reference for Twenty. Each workspace has its own schema — when you add a custom object (say `Invoice`), it immediately gets REST and GraphQL endpoints identical to built-in objects like `Company` or `Person`. The API is generated from the schema, so endpoints use your object and field names directly — no opaque IDs.
|
||||
|
||||
Twenty genera API specifiche per il tuo modello di dati:
|
||||
Your workspace-specific API documentation is available under **Settings → API & Webhooks** after creating an API key. It includes an interactive playground where you can execute real calls against your data.
|
||||
|
||||
* **Nessun ID lungo richiesto**: Utilizza direttamente i nomi degli oggetti e dei campi negli endpoint
|
||||
* **Oggetti standard e personalizzati trattati allo stesso modo**: I tuoi oggetti personalizzati ricevono lo stesso trattamento API di quelli predefiniti
|
||||
* **Endpoint dedicati**: Ogni oggetto e campo ottiene il proprio endpoint API
|
||||
* **Documentazione personalizzata**: Generata specificamente per il modello di dati del tuo workspace
|
||||
## Two APIs
|
||||
|
||||
<Note>
|
||||
La documentazione personalizzata delle tue API è disponibile in **Impostazioni → API & Webhooks** dopo aver creato una chiave API. Poiché Twenty genera API che corrispondono al tuo modello di dati personalizzato, la documentazione è unica per il tuo workspace.
|
||||
</Note>
|
||||
**Core API** — `/rest/` and `/graphql/`
|
||||
|
||||
## I due tipi di API
|
||||
CRUD on records: People, Companies, Opportunities, your custom objects. Query, filter, traverse relations.
|
||||
|
||||
### Core API
|
||||
**Metadata API** — `/rest/metadata/` and `/metadata/`
|
||||
|
||||
Accessibile su `/rest/` o `/graphql/`
|
||||
Schema management: create/modify/delete objects, fields, and relations. This is how you programmatically change your data model.
|
||||
|
||||
Lavora con i tuoi **record** reali (i dati):
|
||||
Both are available as REST and GraphQL. GraphQL adds batch upserts and the ability to traverse relations in a single query. Same underlying data either way.
|
||||
|
||||
* Crea, leggi, aggiorna, elimina Persone, Aziende, Opportunità, ecc.
|
||||
* Interroga e filtra i dati
|
||||
* Gestisci le relazioni tra i record
|
||||
## Base URLs
|
||||
|
||||
### Metadata API
|
||||
|
||||
Accessibile su `/rest/metadata/` o `/metadata/`
|
||||
|
||||
Gestisci il tuo **workspace e il modello di dati**:
|
||||
|
||||
* Crea, modifica o elimina oggetti e campi
|
||||
* Configura le impostazioni del workspace
|
||||
* Definisci le relazioni tra oggetti
|
||||
|
||||
## REST vs GraphQL
|
||||
|
||||
Sia le API Core che le API Metadata sono disponibili nei formati REST e GraphQL:
|
||||
|
||||
| Formato | Operazioni disponibili |
|
||||
| ----------- | ------------------------------------------------------------------------------------- |
|
||||
| **REST** | CRUD, operazioni batch, upsert |
|
||||
| **GraphQL** | Stesse funzionalità + **upsert in batch**, query sulle relazioni in un'unica chiamata |
|
||||
|
||||
Scegli in base alle tue esigenze — entrambi i formati accedono agli stessi dati.
|
||||
|
||||
## Endpoint API
|
||||
|
||||
| Ambiente | URL di base |
|
||||
| ----------------- | ------------------------- |
|
||||
| **Cloud** | `https://api.twenty.com/` |
|
||||
| **Auto-ospitato** | `https://{your-domain}/` |
|
||||
| Ambiente | URL di base |
|
||||
| ----------- | ------------------------- |
|
||||
| Cloud | `https://api.twenty.com/` |
|
||||
| Self-Hosted | `https://{your-domain}/` |
|
||||
|
||||
## Autenticazione
|
||||
|
||||
Ogni richiesta API richiede una chiave API nell'intestazione:
|
||||
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
```
|
||||
|
||||
### Crea una chiave API
|
||||
|
||||
1. Vai a **Impostazioni → APIs & Webhooks**
|
||||
2. Fai clic su **+ Crea chiave**
|
||||
3. Configura:
|
||||
* **Nome**: Nome descrittivo per la chiave
|
||||
* **Data di scadenza**: Quando la chiave scade
|
||||
4. Fai clic su **Salva**
|
||||
5. **Copia subito** — la chiave viene mostrata una sola volta
|
||||
Create an API key in **Settings → API & Webhooks → + Create key**. Copy it immediately — it's shown once. Keys can be scoped to a specific role under **Settings → Roles → Assignment tab** to limit what they can access.
|
||||
|
||||
<VimeoEmbed videoId="928786722" title="Creazione della chiave API" />
|
||||
|
||||
<Warning>
|
||||
La tua chiave API concede l'accesso a dati sensibili. Non condividerla con servizi non affidabili. Se compromessa, disabilitala immediatamente e generane una nuova.
|
||||
</Warning>
|
||||
For OAuth-based access (external apps acting on behalf of users), see [OAuth](/l/it/developers/extend/oauth).
|
||||
|
||||
### Assegna un ruolo a una chiave API
|
||||
## Batch operations
|
||||
|
||||
Per una maggiore sicurezza, assegna un ruolo specifico per limitare l'accesso:
|
||||
Both REST and GraphQL support batching up to 60 records per request — create, update, or delete. GraphQL also supports batch upsert (create-or-update in one call) using plural names like `CreateCompanies`.
|
||||
|
||||
1. Vai a **Impostazioni → Ruoli**
|
||||
2. Fai clic sul ruolo da assegnare
|
||||
3. Apri la scheda **Assegnazione**
|
||||
4. In **Chiavi API**, fai clic su **+ Assegna alla chiave API**
|
||||
5. Seleziona la chiave API
|
||||
## Rate limits
|
||||
|
||||
La chiave erediterà le autorizzazioni di quel ruolo. Vedi [Autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions) per i dettagli.
|
||||
|
||||
### Gestisci chiavi API
|
||||
|
||||
**Rigenera**: Impostazioni → APIs & Webhooks → Fai clic sulla chiave → **Rigenera**
|
||||
|
||||
**Elimina**: Impostazioni → APIs & Webhooks → Fai clic sulla chiave → **Elimina**
|
||||
|
||||
## Playground API
|
||||
|
||||
Testa le tue API direttamente nel browser con il nostro playground integrato — disponibile sia per **REST** sia per **GraphQL**.
|
||||
|
||||
### Accedi al Playground
|
||||
|
||||
1. Vai a **Impostazioni → APIs & Webhooks**
|
||||
2. Crea una chiave API (obbligatorio)
|
||||
3. Fai clic su **REST API** o **GraphQL API** per aprire il playground
|
||||
|
||||
### Cosa ottieni
|
||||
|
||||
* **Documentazione interattiva**: Generata per il tuo specifico modello di dati
|
||||
* **Test in tempo reale**: Esegui chiamate API reali sul tuo workspace
|
||||
* **Esploratore dello schema**: Sfoglia gli oggetti, i campi e le relazioni disponibili
|
||||
* **Generatore di richieste**: Crea query con completamento automatico
|
||||
|
||||
Il playground riflette i tuoi oggetti e campi personalizzati, quindi la documentazione è sempre accurata per il tuo workspace.
|
||||
|
||||
## Operazioni Batch
|
||||
|
||||
Sia REST che GraphQL supportano operazioni batch:
|
||||
|
||||
* **Dimensione batch**: Fino a 60 record per richiesta
|
||||
* **Operazioni**: Creare, aggiornare, eliminare più record
|
||||
|
||||
**Funzionalità esclusive di GraphQL:**
|
||||
|
||||
* **Upsert in batch**: Crea o aggiorna in un'unica chiamata
|
||||
* Usa nomi oggetto al plurale (ad es. `CreateCompanies` invece di `CreateCompany`)
|
||||
|
||||
## Limiti di frequenza delle API
|
||||
|
||||
Le richieste API sono limitate per garantire la stabilità della piattaforma:
|
||||
|
||||
| Limite | Valore |
|
||||
| -------------------- | ---------------------- |
|
||||
| **Richieste** | 100 chiamate al minuto |
|
||||
| **Dimensione batch** | 60 record per chiamata |
|
||||
|
||||
<Tip>
|
||||
Usa le operazioni batch per massimizzare il throughput — elabora fino a 60 record in una singola chiamata API invece di effettuare richieste individuali.
|
||||
</Tip>
|
||||
| Limite | Valore |
|
||||
| ---------- | ---------------------- |
|
||||
| Requests | 100 per minute |
|
||||
| Batch size | 60 record per chiamata |
|
||||
|
||||
Reference in New Issue
Block a user