Quickstart para Site

Do painel admin ao frontend: o caminho mais curto para exibir conteúdo do CMS no seu site.

Este guia mostra o fluxo essencial para usar o Acachy CMS em um site.

1. Criar um Content Type

No admin, vá em Content Types e crie um tipo chamado Post.

Campos sugeridos:

[
  { "name": "title", "type": "text", "required": true },
  { "name": "slug", "type": "slug", "required": true },
  { "name": "excerpt", "type": "textarea" },
  { "name": "cover", "type": "image" },
  { "name": "body", "type": "markdown", "required": true }
]

O CMS cria o slug do tipo automaticamente. Para Post, normalmente será post ou posts, conforme o nome cadastrado.

2. Criar uma Entry

No menu de conteúdo, crie um post:

{
  "title": "Meu primeiro post",
  "slug": "meu-primeiro-post",
  "excerpt": "Resumo curto para cards e SEO.",
  "cover": "https://example.com/cover.jpg",
  "body": "# Conteúdo em Markdown"
}

3. Publicar

Somente entries com status published aparecem na API pública.

Use o botão de publicar no admin ou a rota:

POST /api/admin/entries/:type/:id/publish

4. Criar API Key

Em API Keys, crie uma chave para o site com escopo:

["content:read"]

Copie a chave no momento da criação. Depois ela fica mascarada por segurança.

5. Consumir no Site

Com fetch:

const response = await fetch('https://api.example.com/api/v1/content/posts?limit=6', {
  headers: {
    'x-api-key': process.env.ACACHY_API_KEY!,
  },
})

const posts = await response.json()

Com client:

const posts = await client.findMany('posts', {
  limit: 6,
  sort: 'publishedAt',
  order: 'desc',
})

Checklist

Content Type criado.
Entry publicada.
API key ativa com content:read.
Site usando a URL pública da API.
Nenhum token admin exposto no frontend.