🔑 Workspace API
Программный доступ к ресурсам группы через Bearer-токены — для скриптов, CI, внешних агентов и интеграций.
Workspace API
Framix позволяет обращаться к данным вашей группы напрямую через HTTP — без входа через браузер. Это нужно, когда вы хотите:
- автоматизировать рутину: создавать страницы, добавлять товары, публиковать блог-посты из скрипта или CI;
- интегрировать внешний AI-агент: например, дать Claude или GPT-агенту доступ к вашим данным, чтобы он самостоятельно управлял контентом;
- подключить сторонний сервис: Zapier, n8n, Make — любой инструмент, умеющий делать HTTP-запросы.
Принцип работы
Вы создаёте Workspace API Key — токен вида fmxk_... с выбранным набором прав (скоупов). Этот токен передаётся в заголовке Authorization: Bearer fmxk_... при каждом запросе. Сервер сам определяет, к какой группе относится токен, — workspace-контекст устанавливается автоматически.
Ваш скрипт → Authorization: Bearer fmxk_... → Framix API → данные вашей группы
Токен одноразово показывается при создании. Сохраните сразу — повторно получить его невозможно.
Разделы
- Аутентификация — как получить и использовать токен, формат ответов, коды ошибок.
- Скоупы (права доступа) — таблица всех прав, что они открывают и что запрещено всегда.
- Справочник эндпоинтов — все доступные маршруты с параметрами и примерами ответов.
- Примеры кода — готовые фрагменты для curl, Python, JavaScript, а также инструкция для AI-агента.
Ограничения
| Параметр | Значение |
|---|---|
| Формат токена | fmxk_ + 48 hex-символов |
| Срок действия | По умолчанию бессрочный; при создании можно задать дату истечения |
| Финансы | Заблокированы безусловно — баланс, платежи, карты через API-ключ недоступны |
| Управление ключами | Создавать / удалять ключи через сам ключ — нельзя |
| Блог, Admin | Только для аккаунтов с ролью ADMIN |
Назад Оплата и балансБалансовая модель Framix, тарифы 1990 ₽/мес за сайт и за агента, 7 дней бесплатно для новых, welcome-бонус 100 ₽ на AI, автопополнение, что происходит при нулевом балансе, расходы на AI. Дальше АутентификацияКак получить Workspace API Key, передавать его в запросах и читать ответы.