# API для розробників

Qixoo зроблений так, щоб розробник був не потрібен, але контент, який він зберігає,
відкритий для тебе.

## API контенту

Збережений контент кожного сайту читається як JSON за постійною адресою. Знайти її
можна на картці сайту в **Connect → Content API**, з прикладами на вкладці Code.
Автентифікація — через заголовок `X-API-Key`, який несе те саме значення Site ID, що
стоїть у твоєму сніпеті встановлення.

У відповіді два масиви:

- **`edits`** — усі зміни тексту, посилань, фото і стилів, зроблені в редакторі, кожна
  як `{selector, type, content, updated_at}`. `type` — одне з `text`, `html`, `image`,
  `link` або `style`; `selector` — це CSS-селектор, до якого прив'язана зміна. Правки
  діють на весь сайт: правка застосовується всюди, де збігається її селектор.
- **`blocks`** — блоки з бібліотеки, вставлені через **+ Add**, як
  `{id, type, position, anchor, content.html, updated_at}`, де `type` — це id шаблону.

`site.language` несе мову, якою був згенерований сайт, зроблений ШІ. Для сайту,
підключеного сніпетом, там нічого не зберігається, тому буде `null`.

Відповіді кешуються на 60 секунд. Перекладені мовні версії не включені — вони живуть у
власному сховищі модуля «Мови».

## Вебхуки

Зареєструй адреси, які отримують POST із подією `content.updated` щоразу, коли контент
сайту змінюється. Налаштовуються в **Connect → Webhooks**. Корисне навантаження має ту
саму форму, що й масив `edits` вище. Стане в пригоді для скидання кешів і запуску
перезбирань.

## MCP

Qixoo надає MCP-ендпойнт, тож ШІ-клієнт на кшталт Claude може перелічувати твої сайти
й читати, додавати, оновлювати та видаляти блоки контенту з твоїм токеном. Це дозволяє
керувати контентом сайту просто в розмові з ШІ-асистентом.

## Сценарії застосування

Затягнути відредагований контент у мобільний застосунок або в стрічку. Запустити
перезбирання статичного сайту, коли клієнт зберіг правку. Дати ШІ-асистенту оновити
години роботи клієнта без того, щоб хтось відкривав браузер.