API v2.3

Быстрый старт

API Beta Space управляет пространствами, участниками, устройствами и политиками. Базовый адрес — api.betaspace.io, авторизация по токену пространства.

1. Получите токен

В консоли откройте «Настройки → Интеграции» и создайте токен с ролью members:write.

2. Проверьте пространство

Запросите информацию о пространстве — ответ подтвердит, что токен активен.

3. Добавьте участника

Пригласите сотрудника по email и назначьте роль. Приглашение живёт 72 часа.

Все примеры используют переменную окружения BETA_TOKEN. Не храните ключи в репозитории.

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

Передавайте ключ в заголовке Authorization. Ключ привязан к проекту и роли: для чтения достаточно read, для изменений — write.

terminal — проверка ключа
curl -s https://api.betaspace.io/v1/workspaces \
  -H "Authorization: Bearer $BETA_TOKEN" \
  -H "Accept: application/json"

Эндпоинты

Базовый адрес: https://api.betaspace.io. Все ответы в JSON, коды ошибок описаны ниже.

GET
/v1/workspaces

Список пространств и их лимиты.

POST
/v1/members

Приглашение участника и назначение роли.

GET
/v1/devices

Список устройств с состоянием проверки.

POST
/v1/policies

Создание политики доступа на срок.

GET
/v1/audit-events

Журнал действий участников.

Пример запроса

Создание объекта в регионе eu-central. Ответ содержит идентификатор и состояние обработки.

terminal — create
curl -s -X POST https://api.betaspace.io/v1/workspaces \
  -H "Authorization: Bearer $BETA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "first", "region": "eu-central"}'

Ошибки

Ошибки возвращаются с машиночитаемым полем code и человекочитаемым message.

401Токен отсутствует или отозван.
403Роль не позволяет выполнить действие.
404Пространство или участник не найдены.
429Превышен лимит запросов: 300 в минуту.

SDK и интеграции

Официальные SDK и готовые коннекторы. Если нужного нет — используйте HTTP API, он полностью документирован.

OktaEntra IDGoogle WorkspaceSlackGitHub1PasswordFigmaNotion

История версий

v2.3 — текущая версия API. Совместима с предыдущей, изменения только аддитивные.

  • Обновлены примеры и описания ошибок.
  • Добавлены поля состояния и времени обновления.
  • Beta Space 2.3: офлайн-режим и SCIM — подробности релиза.

Помощь

Не нашли ответ? Поддержка отвечает в рабочие часы, а дежурный инженер — круглосуточно при инцидентах.

Написать в поддержку
Действие выполнено