snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/cs/developers/extend/api.mdx

@@ -0,0 +1,55 @@
+---
+title: API
+icon: plug
+description: REST a GraphQL API generovaná z vašeho schématu pracovního prostoru.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## API schéma pro jednotlivé nájemce
+
+Pro dvacet není žádný statický API odkaz. Každý pracovní prostor má své vlastní schéma — když přidáte vlastní objekt (řekněme `Invoice`), okamžitě získá REST a GraphQL koncové body shodné s vestavěnými objekty, jako je `Company` nebo `Person`. API je generováno z schématu, takže koncové body používají vaše názvy objektů a polí přímo – žádné neprůhledné ID.
+
+Dokumentace API specifická pro pracovní prostor je dostupná v **Nastavení → API a Webhooks** po vytvoření API klíče. Obsahuje interaktivní hřiště, kde můžete uskutečňovat skutečné hovory proti svým datům.
+
+## Dvě API
+
+**Jádro API** — `/rest/` a `/graphql/`
+
+CRUD v záznamech: Lidé, Společnosti, příležitosti, vaše vlastní objekty. Dotazy, filtry, pohybové vztahy.
+
+**Metadata API** – `/rest/metadata/` a `/metadata/`
+
+Správa schémat: vytvořit/upravit/odstranit objekty, pole a vztahy. Takto programově změníte svůj datový model.
+
+Obojí je k dispozici jako REST a GraphQL. GraphQL přidává dávky a schopnost procházet vztahy v jediném dotazu. V každém případě stejné podkladové údaje.
+
+## Základní URL adresy
+
+| Prostředí            | Základní URL              |
+| -------------------- | ------------------------- |
+| Cloud                | `https://api.twenty.com/` |
+| Samostatně hostované | `https://{your-domain}/`  |
+
+## Ověření
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+Vytvořte API klíč v **Nastavení → API & Webhooks → + Vytvořit klíč**. Zkopírujte ji okamžitě - je to zobrazeno jednou. API klíče lze omezit na konkrétní roli v **Settings → Members → Roles → Assignment tab**, aby se omezilo, k čemu mají přístup.
+
+<VimeoEmbed videoId="928786722" title="Vytvoření klíče API" />
+
+Pro přístup založený na OAuthu (externí aplikace jednající jménem uživatelů), viz [OAuth](/l/cs/developers/extend/oauth).
+
+## Provoz šarže
+
+Podpora REST i GraphQL dávkování až 60 záznamů pro každou žádost – vytvořit, aktualizovat nebo smazat. GraphQL také podporuje dávkový náhled (create-or-update v jednom hovoru) pomocí plurálu jako je `CreateCompanies`.
+
+## Míra omezení
+
+| Limit          | Hodnota              |
+| -------------- | -------------------- |
+| Požadavky      | 100 za minutu        |
+| Velikost šarže | 60 záznamů na volání |