# API para desenvolvedores

A Qixoo foi feita para não precisar de desenvolvedor, mas o conteúdo que ela guarda
está aberto para você.

## API de conteúdo

O conteúdo salvo de cada site é legível como JSON numa URL estável. Encontre-a no card
do site em **Connect → Content API**, com exemplos na aba Code. A autenticação usa o
cabeçalho `X-API-Key`, que carrega o mesmo valor do Site ID que está no seu trecho de
instalação.

A resposta tem dois arrays:

- **`edits`** — todas as mudanças de texto, link, foto e estilo feitas no editor, cada
  uma como `{selector, type, content, updated_at}`. `type` é um entre `text`, `html`,
  `image`, `link` ou `style`; `selector` é o seletor CSS ao qual a mudança está
  ancorada. As edições valem para o site inteiro: uma edição se aplica onde quer que o
  seletor dela corresponda.
- **`blocks`** — blocos da biblioteca inseridos pelo **+ Add**, como
  `{id, type, position, anchor, content.html, updated_at}`, em que `type` é o id do
  template.

`site.language` carrega o idioma em que um site feito por IA foi gerado. Num site
conectado pelo trecho nada é guardado ali, então vem `null`.

As respostas ficam em cache por 60 segundos. Versões de idioma traduzidas não são
incluídas — elas vivem no armazenamento próprio do módulo Idiomas.

## Webhooks

Registre URLs que recebem um POST com o evento `content.updated` sempre que o conteúdo
de um site muda. Configure em **Connect → Webhooks**. O payload tem o mesmo formato do
array `edits` acima. Útil para limpar caches e disparar rebuilds.

## MCP

A Qixoo expõe um endpoint MCP, então um cliente de IA como o Claude pode listar os seus
sites e ler, adicionar, atualizar e excluir blocos de conteúdo com o seu token. Isso
permite gerenciar o conteúdo do site conversando com um assistente de IA.

## Casos de uso

Puxar conteúdo editado para um app móvel ou um feed. Disparar o rebuild de um site
estático quando um cliente salva. Deixar um assistente de IA atualizar o horário de
funcionamento de um cliente sem ninguém abrir um navegador.