Возможности API сайтов Vixy
Какие операции доступны сгенерированному сайту и какие ограничения учитывает AI.
Как работает 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.