# Генерация сайта с ИИ

Создайте сайт по текстовому описанию и получите состояние генерации.

Битрикс24 API: `landing.aisite.*`
Скоуп: `landing`

## Операции

- [Запустить генерацию сайта](./ai/generate.md) — `POST /v1/sites/ai/generate`
- [Получить статус генерации](./ai/status.md) — `GET /v1/sites/ai/status`
- [Получить словарь полей генерации](./ai/fields.md) — `GET /v1/sites/ai/fields`
- [Получить одно поле генерации](./ai/field.md) — `GET /v1/sites/ai/fields/:name`

## Доступ

Запросы выполняются от имени владельца вебхука или пользователя, чей токен OAuth использует ключ. Генерация принадлежит этому пользователю Битрикс24, и только он может её прочитать. Ключ READONLY может читать только словарь полей; запуск и получение статуса требуют ключа с разрешённой записью. Доступность возможности и параметры запроса проверяет Битрикс24.

## Черновик и повторные запросы

Запуск забирает единственный свободный черновик ИИ-сайта пользователя. Открытый чат ИИ-сайта теряет этот черновик и требует перезагрузки. Непустой `Idempotency-Key` передаётся без изменений. Пустой или пробельный заголовок считается отсутствующим. Битрикс24 хранит завершённый ответ 24 часа; повтор до сохранения ответа ключом не защищён. Без заголовка каждый вызов запускает новую генерацию.

Битрикс24 автоматически пытается опубликовать созданный сайт. Передавайте в описании только сведения, предназначенные для публичного размещения.

При чтении завершённой или ошибочной генерации ядро может завершить или освободить привязку черновика и учесть отказ модерации. Поэтому получение статуса требует разрешённой записи; ключ READONLY получает `403 WRITE_BLOCKED_READONLY_KEY`. Платформа не повторяет запрос статуса после ошибки 5xx.

## Смотрите также

- [Сайты](../sites.md)
