Basis

Appearance

Módulo de Blog & Publicação ​

O módulo de Blogs é uma solução robusta para gerenciamento de conteúdo editorial. Ele permite criar publicações, organizar categorias, gerenciar autores e multimídia de forma independente dentro de um Workspace.

Este módulo foi projetado para ser flexível e escalável, permitindo que cada Workspace tenha seu próprio blog com configurações, domínios e usuários isolados.

Por que utilizar este módulo? ​

Antes de mergulharmos nos detalhes técnicos, é importante entender que este módulo não é apenas um sistema de postagens simples. Ele foi construído com foco em:

  • Isolamento Total: Cada blog opera como uma entidade única dentro de um Workspace.
  • Ecossistema Editorial: Gerencie sua equipe de redatores sem misturar as credenciais do sistema principal.
  • Liberdade de Frontend: Sendo 100% headless, você consome o conteúdo e decide como e onde exibi-lo.

Autenticação e Contexto ​

A API do blog utiliza headers específicos para identificar o contexto da requisição e garantir a segurança dos dados.

Identificação do Blog ​

Todas as requisições para os endpoints do blog (públicos ou privados) devem incluir o identificador do blog:

HeaderTipoObrigatórioDescrição
X-Blog-IdUUIDSimO identificador único do blog obtido no painel administrativo.

Localização do ID

Após cadastrar um novo blog no backoffice, o X-Blog-Id (UUID) estará disponível nas configurações do blog.

Autenticação Administrativa ​

Para endpoints de escrita (criação, edição e exclusão), é necessário fornecer um token de autenticação:

HeaderValorDescrição
AuthorizationBearer <token>Token de acesso obtido através do login de usuário do blog.

Detalhes Públicos do Blog ​

Antes de consumir o conteúdo, seu frontend pode precisar das configurações gerais do blog (nome, descrição, tema e SEO). Este endpoint é público e exige apenas o header X-Blog-Id.

http
GET /v1/blog/public/detail

Exemplo de Requisição ​

bash
curl -X GET "https://api.us.basis.tavares.in/v1/blog/public/detail" \
  -H "X-Blog-Id: {blog-id}" \
  -H "Accept: application/json"

Respostas ​

200 OK

Retorna as configurações públicas do blog identificado pelo X-Blog-Id.

json
{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Blog de Exemplo",
  "description": null,
  "themeSettings": null,
  "seoConfigs": null,
  "integrations": null,
  "created_at": "2026-03-15T17:44:54.326+00:00"
}

Próximos Passos ​

Agora que você entende a base do módulo, explore as funcionalidades detalhadas: