# Management API

Автоматизируйте настройку доступа для интеграции: создавайте проекты, приглашайте коллег, назначайте роли, выпускайте и отзывайте API/RPC-ключи в существующем рабочем пространстве. Доступные операции ограничены разрешениями управляющего ключа. Создайте пространство и управляющий ключ в личном кабинете.

`mgmt.vilna.io/v1`
`vilna_mgt_` · пространство
REST · JSON
Пространства · проекты · ключи

## Лимиты ресурсов 

[Лимиты workspace](/ru/apis/mgmt/api/workspace/get-workspace-limits) и [лимиты API-ключей проекта](/ru/apis/mgmt/api/project/get-workspace-project-limits) возвращают текущее количество `used` и действующий максимум `max`. Поля workspace не возвращаются, если у ключа нет права на чтение соответствующего ресурса. В число участников входят ожидающие приглашения с неистёкшим сроком. API- и RPC-ключи учитываются до отзыва, даже если срок их действия истёк.

При `max`, равном 0, создание новых ресурсов запрещено; после снижения максимума `used` может его превышать. Эти значения носят справочный характер и не резервируют ёмкость.

## Что можно делать 

- **Журнал активности** - просмотр событий пространства и проектов.
- **Участники и приглашения** - приглашайте коллег, назначайте роли и удаляйте участников.
- **Проекты** - создавайте изолированные проектные среды и управляйте ими.
- **Участники проекта** - назначайте коллег на конкретные проекты с ролями уровня проекта.
- **API-ключи** - создание, получение списка, просмотр метаданных и отзыв ключей Platform API в рамках проекта.
- **RPC-ключи** - создание, получение списка, просмотр метаданных и отзыв ключей в рамках рабочего пространства.


Просмотр и управление управляющими ключами доступны в личном кабинете через пользовательскую сессию. Управляющий ключ не имеет доступа к этим операциям. См. [Ограничения управляющего ключа](/ru/apis/permissions#management-key-limits).

## Иерархия ресурсов 

Всё держится на пространстве:

- **Рабочее пространство (workspace)** - единица верхнего уровня, создаётся в личном кабинете.
  - **Участники и приглашения** - у кого есть доступ к пространству.
  - **RPC-ключи** и **управляющие ключи** - учётные данные уровня пространства.
  - **Проекты** - изолированные среды, у каждой свои адреса, транзакции и ключи.
    - **API-ключи** - учётные данные Platform API уровня проекта.
    - **Участники проекта** - назначение ролей на уровне проекта.


## Ключевые факты 

- **Базовый URL** - `https://mgmt.vilna.io/v1`; ресурсы вложены под `/workspaces/{workspace_id}/`.
- **Аутентификация** - ключ `vilna_mgt_` в заголовке `X-Api-Key`; доступ определяют фиксированные права ключа. См. [Права доступа](/ru/apis/permissions).
- **Формат** - JSON. Один элемент приходит как `{ "item": … }`, список - как `{ "items": […], "meta": {…} }` с пагинацией `?limit=&page=`.
- **Ошибки** - [RFC 7807 problem+json](/ru/apis/errors).


Полный справочник эндпоинтов: [Справочник Management API](/ru/apis/mgmt/api).

## Повтор изменений 

Для каждого POST, PATCH и DELETE нужен `Idempotency-Key`. Сохраните один ключ и параметры запроса для каждого отдельного действия и повторно используйте их при потере ответа. Сроки повтора и восстановление описаны в разделе [Идемпотентность](/ru/apis/idempotency). При неизвестном исходе сначала сверяйте состояние, затем решайте, нужна ли новая операция.