Перейти к содержимому
Последнее обновление

Management API

Management API предоставляет программный доступ к администрированию рабочих пространств, управлению командой и жизненному циклу API-ключей.

Базовый URL

https://mgmt.vilna.io/v1

Аутентификация

Все запросы требуют management API-ключ (префикс vilna_mgt_) в заголовке X-Api-Key. Management-ключи привязаны к рабочему пространству - см. Авторизация для описания ролей и разрешений.

Формат запросов

  • Content-Type: application/json
  • Все ресурсы вложены в /workspaces/{workspace_id}/
  • Пагинация: ?limit=30&page=1 (limit: 1-100, по умолчанию 30)

Формат ответов

Один элемент:

{
  "item": { ... }
}

Список:

{
  "items": [ ... ],
  "meta": {
    "limit": 30,
    "page": 1,
    "total": 10,
    "total_pages": 1
  }
}

Ошибки соответствуют RFC 7807 Problem Details (Content-Type: application/problem+json).

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

Management API покрывает полный жизненный цикл вашей организации в Vilna:

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

Следующие шаги