🔑 Workspace API

Программный доступ к ресурсам группы через Bearer-токены — для скриптов, CI, внешних агентов и интеграций.

Workspace API

Framix позволяет обращаться к данным вашей группы напрямую через HTTP — без входа через браузер. Это нужно, когда вы хотите:

  • автоматизировать рутину: создавать страницы, добавлять товары, публиковать блог-посты из скрипта или CI;
  • интегрировать внешний AI-агент: например, дать Claude или GPT-агенту доступ к вашим данным, чтобы он самостоятельно управлял контентом;
  • подключить сторонний сервис: Zapier, n8n, Make — любой инструмент, умеющий делать HTTP-запросы.

💡 Хотите управлять группой прямо из нейросети? Подключите Framix как MCP-коннектор в Claude Desktop, Cursor или другом MCP-клиенте — и просите ИИ словами: «добавь товары», «покажи новые лиды», «создай лендинг». Под капотом тот же API и тот же ключ.

Принцип работы

Вы создаёте Workspace API Key — токен вида fmxk_... с выбранным набором прав (скоупов). Этот токен передаётся в заголовке Authorization: Bearer fmxk_... при каждом запросе. Сервер сам определяет, к какой группе относится токен, — workspace-контекст устанавливается автоматически.

Ваш скрипт → Authorization: Bearer fmxk_... → Framix API → данные вашей группы

Токен одноразово показывается при создании. Сохраните сразу — повторно получить его невозможно.

Разделы

  • Аутентификация — как получить и использовать токен, формат ответов, коды ошибок.
  • Скоупы (права доступа) — таблица всех прав, что они открывают и что запрещено всегда.
  • Справочник эндпоинтов — все доступные маршруты с параметрами и примерами ответов.
  • Примеры кода — готовые фрагменты для curl, Python, JavaScript, а также инструкция для AI-агента.
  • MCP-сервер — подключение Framix как MCP-коннектора, чтобы нейросеть управляла группой через тот же ключ.

Ограничения

ПараметрЗначение
Формат токенаfmxk_ + 48 hex-символов
Срок действияПо умолчанию бессрочный; при создании можно задать дату истечения
ФинансыЗаблокированы безусловно — баланс, платежи, карты через API-ключ недоступны
Управление ключамиСоздавать / удалять ключи через сам ключ — нельзя
Блог, AdminТолько для аккаунтов с ролью ADMIN

На этой странице