API Pública

A API pública é feita para o frontend. Ela lê apenas conteúdo publicado e exige uma API key com escopo content:read.

x-api-key: ck_live_<sua-api-key>

API keys são isoladas por projeto. Uma chave só acessa o conteúdo do projeto onde foi criada.

Listar conteúdo

GET /api/v1/content/:type?page=1&limit=10

Exemplo:

GET /api/v1/content/posts?limit=6&sort=publishedAt&order=desc&fields=title,slug,excerpt

Query params úteis:

Param	Uso
`page`	Página atual.
`limit`	Itens por página, até 100.
`sort`	`createdAt`, `updatedAt`, `publishedAt` ou `slug`.
`order`	`asc` ou `desc`.
`search`	Busca textual simples.
`fields`	Campos retornados, separados por vírgula.

Resposta típica:

{
  "data": [
    {
      "id": "entry-id",
      "slug": "meu-post",
      "title": "Meu post",
      "excerpt": "Resumo curto"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 6,
    "total": 1,
    "totalPages": 1
  }
}

Buscar uma entry

GET /api/v1/content/:type/:id
GET /api/v1/content/:type/slug/:slug

Use busca por slug para páginas públicas, como /blog/meu-post.

Buscar texto

GET /api/v1/search/:type?q=portfolio&page=1&limit=10

A query precisa ter pelo menos 2 caracteres.

Media

GET /api/v1/media?page=1&limit=20
GET /api/v1/media/:id

Use essas rotas quando o site precisar listar mídia cadastrada no projeto.

Regras importantes

A API pública não retorna drafts.
Use cache no frontend quando possível.
Nunca use token admin no frontend.
Crie keys separadas por site/aplicação quando precisar revogar acesso sem afetar outros consumidores.