Start here

/docs/skill/vizen-startcurrentМашинный перевод с английского

Твой key's contour Где писать пишется: production изменениях, live shop; dev пишет в a draft До публикации.Читать далее writes_to_live и warnings в паспорт first, Затем выберите задачу's path.

0.Покончить с этим site, папка или export? Остановись здесь.

папка с index.html, а React/Vite строение или Figma/Webflow/Tilda export существует: вы есть Перенос, а не строительство. Двигайся, как есть. Не резать. вводить blocks или комплектующих, если вас не попросят. читать паспорт (§1), то:

Владелец хочет	Путь
Весь сайт сам по себе, байт за байтом	папка сайта: категория `type:"site"` → ZIP то `POST /site-folders/{id}/releases/zip?base=none&publish=1` → Опубликовать категорию; `/docs/file-storage`. Нет заголовка магазина, тележки или `vz-` ключи внутри; ключ dev оставляет только черновик
сайт как магазин — живые цены, тележка, меню	`vizen-transfer`: одна папка на страницу = виджет уровня 3, плюс макет и хром
Одна страница внутри магазина	`vizen-transfer` §3 шаг 5: одна папка = виджет уровня 3 на этой странице
сайт папки или раздел на `/`	`PUT /v1/home-page {"section_id":id}`, `/docs/file-storage`

Если не ясно, спросите у owner Один вопрос: отдельный site Как это есть или shop с live цены и cart. Не выбирайте для owner.

0а. Один. page или весь site? The layout решать

Что? owner хотеть	Куда он идет
один page (приземление, промо)	ан html widget на этом page — `--page <slug>`
что-то на каждый page: общий CSS, шрифты, `<head>`, а favicon, а script	тот LAYOUT's папка — `--theme <id>`, `vizen-own-markup` §6.2
header/footer для всего site или для одного section	groups привязанный slots, на shop, а section, или layout — `vizen-chrome`

общий CSS Войдет в layout папка: preview и охраняемый pages load это; необязательный header оставлять.

А. layout это group с group_type:"theme"; тот default Самый ранний из них id ("основной"). GET /content-blocks не имеет filter — filter В охраняемых зонах (/cart, /checkout, /account, /wishlist, /orders, /coupons, /deals, /dashboard) нет author script бегать — layout code включено; разметка и стили остаются.

1.Читать далее key паспорт

Читать аутентификация, затем GET /v1/account/token before Пишите, следуйте за ним. mode_guide и пройти warnings в owner. Публичные ответы каталога не проверяют key. Аутентификация принадлежит field и error не выдавайте разрешения из заранее установленного name.

Замена а category сетка: семья cards учебный; канонический API последовательность и откат являются /docs/components §4.8.

2.Задать три вопроса before тот first писать

Триггерные слова: «уникальный», «не такой, как остальные», «полностью» custom”. Перед тем как писать, Разрешите вилки ниже с помощью owner Если же они не открыты, то это неверный ответ. Стоимость одного маршрута составляет 12% от его стоимости. steps). Если owner Вы уже выбрали, следуйте этому выбору; не просите одобрения снова..

Вопрос	Путь А	Путь Б
Заголовок, menu, footer	платформа widgets — быстро, props/CSS рестайлинг	own разметка в HTML block — Ваша структура нуждается в chrome group обязательный
"«Уникальный», «не такой, как остальные»"	Обычно ни один из крайних: keep тот widget И положите свой own class на его wrapper (`props.wrapperClass`), И тогда вы будете отступать от своего own CSS	own разметка когда owner хочет контролировать структуру или авторство;
Списки продуктов	платформа `productListing` — фильтры, paging, сортировка; props/CSS рестайлинг	own Разметка — ваша структура и live цены (`vz-for="p in products"`); Нет встроенных фильтров
Продукт card	Изменить его на один product	Изменить его для каждого product из одного section — `category_children` Наследует все в целом tree
нуждающийся more не один раз?	один page — ан html widget	много pages, различный content — а компонент (`vizen-own-markup` §6.3): одна папка, values на вставку

Объясните реальный компромисс: own-разметка feed иметь live Цены, но не встроенные filter/sort контроль; явные пики: /docs/own-markup §2.Не описывайте его как замороженный. data.

§6.2 и § 6.3 являются sections из vizen-own-markup мастерство; в /docs/own-markup тот layout это §7.2, компоненты являются /docs/components.

3.Выберите навык

Задача состоит в том, чтобы	мастерство
законченный site, folder, строить или export то move Как есть	§0: a site folder (`/docs/file-storage`) или `vizen-transfer` (`/docs/transfer`)
Конфигурирующая платформа blocks, их props и limits	`vizen-widgets`
own HTML/CSS/JS, vz- ключи, модальности, глобальные CSS	`vizen-own-markup`
Одинаковая накладка на многие pages с разными content	`vizen-own-markup` §6.3, площадь `GET /docs/components`
site-широкий CSS/fonts/scripts, favicon, секундочку design для одного section	`vizen-own-markup` (§6.2, то layout folder), `vizen-chrome` (§2а)
тот cart, checkout, account pages — их header и footer	`vizen-chrome` §2а, system pages
делать любой block look уникальный — own class на wrapper, или один wrapper ось	`vizen-own-markup` (§4), площадь `GET /docs/own-markup` §5
header, menu, footer, макеты, второй chrome комплект	`vizen-chrome`
products, categories, фильтры, images, import, рекорд sets; редакционный pages и корма (`GET /docs/news`)	`vizen-catalog`
цены, скидки, промо-коды, combo sets	`vizen-catalog`, затем `GET /docs/promotions`
forms, own викторины, leads, CRM Интерфейс и Webhook test режимы	`GET /docs/forms`; `GET /docs/webhooks`
"I set 200, ничего не изменилось"	`vizen-troubleshoot`
closing тот site Пока он построен (PIN, hidden от гусеничных)	район `GET /docs/resource-access`

4.Два правила, которые применяются везде

Смотри. before Ты пишешь. Наименования полей, энум values И дефолты приходят из GET /docs/widgets и GET /docs/vz-keys.json, Не по памяти — оба порождены реальным code. Попросите один вход: ?kind= и ?key=.

подтверждать before Ты пишешь. POST /docs/validate принимает exact sections Список, который вы собирались PUT Ответы на каждый path: applied, ignored, unknown или unverified (нет schema — Это ничего не значит, так что Нет никакого reason Не называть это.

POST /docs/validate   {"sections":[ … ]}

Используйте его, потому что неудачи, которые он ловит, являются молчать: Написанный рядом kind вместо того, чтобы под props не хранится и не выдает ничего; value вне пределов ENUM принимается и default нарисован; "12" где number Принадлежит читать Сзади как default. Каждый ответ 200.

Проверяйте, глядя, а не status code. Даже after чистый validation, перечитать объект и открыть его page. Валидатор знает, что schema; не знает, Если бы id Вы упомянули, существует ли result Выглядит правильно.

5.Никогда.

print Токен — не в ответах, files, маркировка или отчеты;
Написать в кабинет, cart или checkout поток;
использовать git В общем, вы работаете через API только.

Исходник: https://api.vizen.shop/docs/skill/vizen-start?full=1

← Назадllms.txt — reading order for agents Далее →Transfer a finished site