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

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

@@ -0,0 +1,55 @@
+---
+title: API
+icon: plug
+description: REST и GraphQL API, сгенерированные на основе схемы вашего рабочего пространства.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## API с отдельной схемой для каждого тенанта
+
+Для Twenty нет статической документации по API. У каждого рабочего пространства своя схема — когда вы добавляете пользовательский объект (например, `Invoice`), он сразу получает эндпоинты REST и GraphQL, идентичные встроенным объектам, таким как `Company` или `Person`. API генерируется из схемы, поэтому эндпоинты напрямую используют названия ваших объектов и полей — никаких непрозрачных идентификаторов.
+
+Документация по API для вашего рабочего пространства доступна в разделе **Настройки → API и вебхуки** после создания ключа API. Она включает интерактивную песочницу, где вы можете выполнять реальные вызовы к своим данным.
+
+## Два API
+
+**Основное API** — `/rest/` и `/graphql/`
+
+CRUD над записями: Люди, Компании, Сделки, ваши пользовательские объекты. Запросы, фильтрация, переход по связям.
+
+**API метаданных** — `/rest/metadata/` и `/metadata/`
+
+Управление схемой: создание/изменение/удаление объектов, полей и связей. Так вы программно изменяете свою модель данных.
+
+Оба доступны как REST и GraphQL. GraphQL добавляет пакетные upsert-операции и возможность переходить по связям в одном запросе. В обоих случаях используются одни и те же базовые данные.
+
+## Базовые URL-адреса
+
+| Среда                   | Базовый URL               |
+| ----------------------- | ------------------------- |
+| Облако                  | `https://api.twenty.com/` |
+| Самостоятельный хостинг | `https://{your-domain}/`  |
+
+## Аутентификация
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+Создайте ключ API в **Settings → API & Webhooks → + Create key**. Сразу скопируйте его — он показывается только один раз. Ключам можно задать область действия для конкретной роли в разделе **Settings → Members → Roles → Assignment tab**, чтобы ограничить их доступ.
+
+<VimeoEmbed videoId="928786722" title="Создание ключа API" />
+
+Для доступа на основе OAuth (внешние приложения, действующие от имени пользователей), см. [OAuth](/l/ru/developers/extend/oauth).
+
+## Пакетные операции
+
+И REST, и GraphQL поддерживают пакетную обработку до 60 записей за один запрос — создание, обновление или удаление. GraphQL также поддерживает пакетный upsert (создание или обновление за один вызов), используя имена во множественном числе, например `CreateCompanies`.
+
+## Лимиты скорости
+
+| Лимит         | Значение                  |
+| ------------- | ------------------------- |
+| Запросы       | 100 запросов в минуту     |
+| Размер пакета | 60 записей за один запрос |