56 lines
2.7 KiB
Plaintext
56 lines
2.7 KiB
Plaintext
---
|
|
title: API-uri
|
|
icon: plug
|
|
description: API-urile REST și GraphQL generate din schema spațiului tău de lucru.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
## API-uri cu schemă per-tenant
|
|
|
|
Nu există o referință API statică pentru Twenty. Fiecare spațiu de lucru are propria schemă — când adaugi un obiect personalizat (de exemplu `Invoice`), acesta primește imediat endpoint-uri REST și GraphQL identice cu cele ale obiectelor încorporate precum `Company` sau `Person`. API-ul este generat din schemă, astfel încât endpoint-urile folosesc direct denumirile obiectelor și câmpurilor tale — fără ID-uri opace.
|
|
|
|
Documentația API specifică spațiului tău de lucru este disponibilă la **Settings → API & Webhooks** după crearea unei chei API. Include un mediu interactiv de testare în care poți executa apeluri reale asupra datelor tale.
|
|
|
|
## Două API-uri
|
|
|
|
**API de bază** — `/rest/` și `/graphql/`
|
|
|
|
CRUD pe înregistrări: Persoane, Companii, Oportunități, obiectele tale personalizate. Interogare, filtrare, parcurgere a relațiilor.
|
|
|
|
**API de metadate** — `/rest/metadata/` și `/metadata/`
|
|
|
|
Administrarea schemei: creare/modificare/ștergere de obiecte, câmpuri și relații. Așa îți modifici programatic modelul de date.
|
|
|
|
Ambele sunt disponibile ca REST și GraphQL. GraphQL adaugă upsert-uri în lot și posibilitatea de a parcurge relațiile într-o singură interogare. Aceleași date de bază, indiferent de metodă.
|
|
|
|
## URL-uri de bază
|
|
|
|
| Mediu | URL de bază |
|
|
| ---------------- | ------------------------- |
|
|
| Cloud | `https://api.twenty.com/` |
|
|
| Găzduire proprie | `https://{your-domain}/` |
|
|
|
|
## Autentificare
|
|
|
|
```
|
|
Authorization: Bearer YOUR_API_KEY
|
|
```
|
|
|
|
Creează o cheie API în **Settings → API & Webhooks → + Create key**. Copiază-o imediat — este afișată o singură dată. Cheile pot fi limitate la un rol specific în **Settings → Members → Roles → Assignment tab** pentru a restricționa la ce pot avea acces.
|
|
|
|
<VimeoEmbed videoId="928786722" title="Crearea unei chei API" />
|
|
|
|
Pentru acces bazat pe OAuth (aplicații externe care acționează în numele utilizatorilor), vezi [OAuth](/l/ro/developers/extend/oauth).
|
|
|
|
## Operațiuni de grup
|
|
|
|
Atât REST, cât și GraphQL acceptă procesarea în lot de până la 60 de înregistrări per cerere — creare, actualizare sau ștergere. GraphQL acceptă, de asemenea, upsert în lot (creare-sau-actualizare într-un singur apel) folosind nume la plural precum `CreateCompanies`.
|
|
|
|
## Limitări de rată
|
|
|
|
| Limită | Valoare |
|
|
| ------------------- | -------------------------- |
|
|
| Solicitări | 100 pe minut |
|
|
| Dimensiunea lotului | 60 de înregistrări pe apel |
|