Вся документация
Разработка

Возможности API сайтов Vixy

Какие операции доступны сгенерированному сайту и какие ограничения учитывает AI.

2 мин чтенияОбновлено: Mon Nov 09 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Как работает API проекта

Vixy автоматически добавляет в созданный сайт готовый объект window.vixy. Его не нужно устанавливать через npm, подключать с CDN или инициализировать вручную.

AI получает актуальную документацию только по тем возможностям, которые относятся к запросу. Например, при создании интернет-магазина ему передаются правила базы данных и ЮKassa, а при обычной визуальной правке платёжная документация не расходует контекст.

Встроенные данные

Для CRUD используйте vixy.from("table"). Начальные данные проекта находятся в _seed.json, а доступ к таблицам задаётся в _baas-policy.json. Поля записей должны совпадать с полями, которые читает интерфейс.

const { data, error } = await vixy
  .from("products")
  .select("*")
  .eq("active", true);

Авторизация посетителей

Регистрация, вход и сессия работают через vixy.auth. Пароли нельзя отправлять через формы или сохранять в обычных таблицах.

Формы

Заявки отправляются через vixy.forms.submit(formId, payload). Формы нельзя использовать для паролей, платёжных секретов и токенов.

ЮKassa

Платёж создаётся только через vixy.integrations.yookassa.createPayment. Браузер передаёт идентификаторы товаров и количество, а сервер рассчитывает сумму по таблице products. Поля amount, price, deliveryCost, shopId и secretKey не поддерживаются.

Платная доставка оформляется как скрытая позиция products с отдельным ID и серверной ценой. Подробный пример приведён в инструкции «Приём платежей через ЮKassa».

Supabase

Подключённая база доступна через vixy.integrations.supabase.from(table). Адаптер поддерживает PostgREST CRUD и RLS, но не Supabase Auth, Realtime, Storage, RPC или Edge Functions. Ключи не добавляются в исходники сайта.

Внешние API

Публичные API вызываются через vixy.proxy. Для API с секретами используются декларативные _functions/*.json и vixy.functions.invoke. Готовые интеграции из каталога не нужно повторно реализовывать через функции.

Если нужной операции нет в документации и интерфейсе интеграций, AI не должен имитировать её. Создайте обращение в поддержку или используйте доступный внешний backend.