API и MCP

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

API и MCP

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

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

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

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

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

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

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

Разделы

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

Ограничения

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

Не нашли ответ? Напишите в поддержку — отвечаем по будням.