API da documentação (para chatbot e LLM)

Esta documentação é publicada também em formato de máquina, para que um chatbot ou um assistente de IA responda dúvidas de cliente com o texto oficial em vez de improvisar.

Todos os endereços são públicos, respondem `GET` e aceitam requisição de qualquer origem (CORS liberado).

Índice em JSON

```
GET /api/docs
```

Devolve as categorias e a lista de artigos com título, resumo, palavras-chave, data de atualização e URL.

Um artigo

```
GET /api/docs/{categoria}/{slug}
```

Devolve o artigo com o corpo em markdown. Exemplo: `/api/docs/shop/link-de-carrinho-e-cupom`.

Busca

```
GET /api/docs/search?q=cupom
```

Devolve os artigos ordenados por relevância, com um trecho do texto em volta do termo. Aceita `limite` (padrão 10) e `categoria`.

Formato para LLM

```
GET /llms.txt índice em markdown
GET /llms-full.txt a documentação inteira, em um arquivo
```

O `/llms.txt` segue a convenção de mesmo nome: um índice enxuto para o modelo saber o que existe. O `/llms-full.txt` traz tudo, e serve para carregar num contexto ou indexar num banco vetorial.

> Estes endpoints são somente leitura e não expõem dado de cliente: eles servem apenas o texto da documentação pública.