Blog no seu site (API de conteúdo)

O que é o Blog no seu site?

É o jeito de usar o JornalBox sem ter site no JornalBox. O JornalBox continua escrevendo, revisando, publicando e postando nas redes, e o seu site (loja, site institucional, sistema) mostra as matérias no blog dele, com o topo, o menu, as cores e o domínio dele, por exemplo em suaempresa.com.br/blog ou blog.suaempresa.com.br.

Cada site da sua conta funciona de um de dois jeitos, escolhidos em Configurações › Site ou só API: Site do JornalBox (o padrão, com os temas) ou Só a API, no blog do meu site. A ligação é feita por uma chave: o seu site pede as matérias publicadas e recebe tudo pronto, em JSON. Para sites em PHP existe um kit com as páginas do blog já feitas.

• Página Blog no seu site

Para quem serve o Blog no seu site?

Para quem já tem um site e quer um blog atualizado dentro dele sem trocar de plataforma:

• lojas virtuais e sites institucionais com o blog parado;
• sistemas e SaaS que querem conteúdo para atrair clientes pelo Google;
• agências que cuidam do site de vários clientes.

Se você ainda não tem site, use o modo Site do JornalBox: ele já resolve, sem API.

O que o meu site recebe de cada matéria?

Título, resumo, o texto completo em HTML, capa (com texto alternativo, legenda e crédito), galeria, vídeo, categoria principal e extras, tags, autor (nome, cargo, minibio e foto), dados de SEO (título, descrição, imagem de compartilhamento e palavra-chave), data de publicação com fuso, o endereço da matéria no seu site e 3 matérias relacionadas.

Imagens dentro do texto já saem com o endereço completo, e links para outras matérias do mesmo site já apontam para o seu blog.

• Documentação da API

Rascunhos e matérias agendadas aparecem no meu site?

Não. A API só entrega matérias com o status Publicada. Rascunhos, agendadas e arquivadas ficam só no painel. Se você despublicar ou apagar uma matéria, ela some do seu blog na próxima atualização do cache.

Quanto custa o Blog no seu site?

Não tem custo a mais: o modo Só a API está em todos os planos. As matérias continuam contando no limite de matérias do plano, como sempre; a API não gasta matéria nem crédito de IA.

• Preços

No modo Só a API ainda existe site no JornalBox?

Não para os leitores. O endereço do JornalBox (subdomínio ou domínio ligado a ele) deixa de mostrar o site: quem abrir uma matéria lá é levado (redirecionamento 301) para a mesma matéria no seu blog, e as outras páginas levam para a página do blog.

O painel continua igual para escrever, rodar campanhas de IA e RSS, postar nas redes e acompanhar tudo. Só o que monta o visual do site (temas e Layout) sai do menu.

O que acontece com os temas e o Layout no modo Só a API?

Ficam ocultos: o menu Layout (temas, editor fácil e editor complexo) e o menu Outros (enquetes e top músicas) somem do painel, porque o visual passa a ser todo do seu site. Quem tentar abrir essas telas pelo endereço é levado para Configurações › Site ou só API, com um aviso.

Nada é apagado: voltando para Site do JornalBox, o tema e as configurações de layout reaparecem como estavam.

• Abrir Configurações › Site ou só API

Posso ter o site do JornalBox e a API ao mesmo tempo?

No mesmo site, não: ou o JornalBox mostra as matérias (modo Site do JornalBox), ou o seu site mostra (modo Só a API), e assim o Google vê cada matéria num lugar só. Se precisar dos dois, crie outro site na sua conta e use cada um num modo.

Como passo a usar só a API?

1. No painel, abra Configurações › Site ou só API.
2. Marque Só a API, no blog do meu site.
3. Preencha a Página do blog com o endereço do blog no seu site (ex.: https://suaempresa.com.br/blog ou https://blog.suaempresa.com.br).
4. Clique em Salvar e confirme. A chave aparece na mesma tela.

Instale o blog no seu site antes ou logo depois: a partir do salvamento, o endereço do JornalBox já manda os leitores para a página do blog. Cada site do JornalBox tem a própria chave; uma conta com vários sites pode alimentar vários blogs.

• Abrir Configurações › Site ou só API

Como volto a usar o site do JornalBox?

Em Configurações › Site ou só API, marque Site do JornalBox e salve. O endereço do JornalBox volta a mostrar o site com o tema, Layout e Outros voltam ao menu e a API para de responder ao seu site (o blog dele mostra a última versão guardada no cache e depois fica vazio).

• Abrir Configurações › Site ou só API

Onde fica a chave da API e como troco?

Em Configurações › Site ou só API, com o site no modo Só a API, no campo Chave da API, com o botão Copiar. Ela começa com jb_.

Para trocar, use Criar chave nova no fim da tela: a chave antiga para de funcionar na hora, então cole a nova no seu site logo em seguida. A chave só lê matérias publicadas, mas não a publique em fórum ou repositório público.

• Abrir Configurações › Site ou só API

O que pôr em "Página do blog" e "Endereço de cada matéria"?

Página do blog é onde fica a lista de matérias no seu site, por exemplo https://suaempresa.com.br/blog ou https://blog.suaempresa.com.br. É obrigatória no modo Só a API.

Endereço de cada matéria é opcional. Vazio, vale a página do blog + o endereço da matéria (/blog/nome-da-materia), que é o padrão do kit. Se o seu site usa outro formato, escreva o modelo com {slug} e, se precisar, {categoria}, por exemplo https://suaempresa.com.br/artigos/{categoria}/{slug}.

Esses endereços entram no campo url da API, no feed RSS e no redirecionamento.

Quem pode escolher entre site e só API?

O dono da conta e os usuários com papel de administrador do site, que são os que veem Configurações. Editores e autores continuam escrevendo normalmente nos dois modos.

Como sei se o meu site está chamando a API?

Em Configurações › Site ou só API, a parte Testar e acompanhar mostra quantas chamadas o seu site fez hoje e ontem. O botão Testar agora chama a API na hora e lista as 3 matérias mais novas, com os links que o seu site vai usar.

• Abrir Configurações › Site ou só API

Como instalo o kit PHP do Blog no seu site?

1. Baixe o kit e envie a pasta blog para a raiz do seu site.
2. Em blog/config.php, cole a chave, o endereço da pasta (ex.: https://suaempresa.com.br/blog) e o nome do site.
3. Troque blog/topo.php e blog/rodape.php pelo topo e rodapé do seu site.
4. Abra seusite.com.br/blog.

Precisa de PHP 7.4 ou mais novo, com cURL, e de Apache com mod_rewrite (em Nginx, mande /blog/ para /blog/index.php). A pasta blog/cache precisa ser gravável.

• Baixar o kit PHP
• Documentação da API

Como o blog fica com o topo e o rodapé do meu site?

O kit monta só o miolo (lista e matéria). O topo e o rodapé vêm de blog/topo.php e blog/rodape.php: coloque neles o mesmo cabeçalho, menu e rodapé do seu site, ou inclua os arquivos que o seu site já usa.

No topo, mantenha <?= $head ?> dentro do <head>: é ele que leva o título, a descrição e as tags de SEO de cada página. O HTML da lista e da matéria fica em blog/modelos/ e o visual em blog/blog.css, que herda a letra e as cores do seu site.

Meu site não é em PHP. Dá para usar?

Dá. A API é um endereço que devolve JSON, então funciona com Node.js, Next.js, Python, Ruby, .NET ou qualquer linguagem que faça uma requisição GET. Chame no servidor (não no navegador), para o Google ler o texto da matéria.

Envie a chave no cabeçalho Authorization: Bearer SUA_CHAVE e um User-Agent com o nome do seu site: requisição sem User-Agent é recusada pelo firewall.

• Documentação da API

O Blog no seu site funciona com WordPress?

Funciona de dois jeitos: instalando o kit numa pasta /blog ao lado do WordPress (com topo e rodapé copiados do tema), ou chamando a API dentro de um modelo do tema. Ainda não há plugin pronto. Em plataformas fechadas (Wix, Shopify e parecidas) só dá com os recursos de código que elas oferecem.

Dá para mostrar as últimas matérias na página inicial do meu site?

Sim. Com o kit, em qualquer página PHP do seu site:

$jb = new JornalBoxBlog(require 'blog/config.php');
$ultimas = $jb->posts(['por_pagina' => 3]);

Depois é só mostrar titulo, capa e o link $jb->link($p['slug']) de cada uma. Dá para filtrar por categoria com 'categoria' => 'slug-da-categoria'.

Posso chamar a API direto do navegador, com JavaScript?

Pode: a API aceita chamadas de qualquer domínio (CORS liberado) e a chave só lê matérias publicadas. Mas o texto montado no navegador quase não conta para o Google. Para o blog principal, prefira montar a página no servidor; o navegador serve bem para blocos como "últimas matérias" numa página que já existe.

As matérias da API contam para o SEO do meu site?

Sim, desde que a página seja montada no servidor (o kit faz isso). Cada matéria fica no seu domínio com título e descrição de SEO, canonical apontando para o endereço no seu site, Open Graph para as redes e JSON-LD de artigo.

E o Google não vê a mesma matéria em dois lugares: no modo Só a API o endereço do JornalBox redireciona (301) para o seu blog e o sitemap de lá fica vazio.

E o sitemap do blog no meu site?

O kit gera o sitemap em seusite.com.br/blog/sitemap.xml, com todas as matérias publicadas (até 5.000) e a data de cada uma. Envie esse endereço no Google Search Console do seu domínio. Em outra linguagem, monte o sitemap com o recurso /api/v1/sitemap.

E os links nas redes sociais e no feed RSS?

No modo Só a API, o feed RSS já sai com os links do seu blog. Os cards do auto-post continuam com o endereço do JornalBox, que redireciona: quem clica cai na matéria do seu blog.

As imagens das matérias ficam onde?

Continuam hospedadas no JornalBox e são entregues por CDN. O seu site só mostra, sem ocupar espaço nem banda da sua hospedagem.

Quanto tempo uma matéria nova leva para aparecer no meu site?

A API atualiza a cada minuto. O kit guarda cada resposta por 5 minutos (dá para mudar em cache_minutos no blog/config.php). Então, na prática, até uns 6 minutos depois de publicada.

A API tem limite de chamadas?

Sim: 300 chamadas por minuto por site. Passando disso, a API responde 429 com o cabeçalho Retry-After. Com cache no seu site (o kit já faz) você fica muito abaixo disso, mesmo com muitos visitantes.

A API respondeu 401 (chave inválida). O que fazer?

Confira no painel, em Configurações › Site ou só API:

• se o site está no modo Só a API, no blog do meu site (no modo Site do JornalBox a API não responde);
• se a chave no seu site é a mesma da tela (alguém pode ter criado uma chave nova);
• se a chave vai no cabeçalho Authorization: Bearer, sem espaço sobrando.

• Abrir Configurações › Site ou só API

A API respondeu 403. O que fazer?

Com a mensagem site_inativo, o site está suspenso ou cancelado no JornalBox, normalmente por fatura em aberto: veja em Meu plano. Sem corpo JSON, é o firewall recusando a requisição: envie um User-Agent com o nome do seu site.

• Meu plano

O blog do meu site ficou desatualizado ou vazio. E agora?

• Use Testar agora no painel: se ele lista as matérias, a API está bem e o problema é no seu site.
• Confira se a pasta blog/cache é gravável pelo PHP.
• Se a API falhar, o kit continua mostrando a última resposta boa que guardou; um blog vazio costuma ser chave errada já na primeira chamada.

O que a API do Blog no seu site não faz?

• Não publica nem edita matérias: é só leitura. Escrever continua sendo pelo painel, pela IA ou pelo RSS.
• Não entrega rascunhos, agendadas, comentários nem dados de visitantes.
• Não instala nada no seu site sozinha nem tem plugin pronto para WordPress, Wix ou Shopify.