Skip to content
Começar grátis

Integrações · API de conteúdo

Para o site feito por desenvolvedor, sem WordPress e sem Wix. O site busca os posts publicados numa API de leitura, com a chave do site, e monta as páginas do jeito dele, no caminho que você definir.

  • Uma chave do site, guardada no servidor
  • Lista, post completo e sitemap, por idioma
  • O visual e o endereço do blog continuam do seu site
Publicar meus 4 posts grátisVer como funciona

Sem cartão · 4 posts no total, em 1 site

Passo a passo

  1. Escolha Site do desenvolvedor

    No portal, em Configuração, Conexão, escolha Site do desenvolvedor e defina o prefixo do blog. Sem mudar, os posts ficam em /blog.

  2. Gere a chave do site

    Em API keys do site, gere uma chave. Ela começa com bpa_ck_ e aparece inteira uma vez só: copie na hora.

  3. Guarde no servidor

    O desenvolvedor guarda a chave numa variável de ambiente do servidor e envia no cabeçalho x-bpa-api-key em cada leitura. Testar conexão do site, no portal, confirma a chave.

  4. Monte as páginas uma vez

    Com a API, o desenvolvedor monta a lista de posts, a página do post e as entradas do sitemap. Depois disso, cada post publicado aparece no site pela própria API.

O que a API entrega

  • GET /me

    O site, o status da conta, os idiomas e o caminho do blog.

  • GET /posts?locale=pt

    Os posts publicados do idioma, do mais novo ao mais antigo: título, descrição, data, capa, tags, autor e tempo de leitura. Sem o HTML.

  • GET /posts/{locale}/{slug}

    O post completo, com o HTML, as medidas da capa e o slug das versões em outros idiomas, quando existem.

  • GET /sitemap

    O caminho, a data da última mudança e o slug em cada idioma de cada post, para o sitemap.xml e o hreflang do site.

POST /validate confirma a chave. A API só lê: o site não cria nem edita posts por ela.

Exemplo

O endereço da API aparece no portal, junto com a chave.

# A chave fica numa variável de ambiente do servidor
BPA_CONTENT_API_KEY=bpa_ck_…

# Os posts publicados em português
GET /posts?locale=pt
x-bpa-api-key: bpa_ck_…

# Um post completo, com o HTML
GET /posts/pt/{slug}
x-bpa-api-key: bpa_ck_…

Limites

  • A API só lê. Criar, editar e aprovar posts continua no painel do BlogPost.
  • Só posts publicados: rascunho ou slug que não existe respondem 404.
  • O Google lê o sitemap.xml do seu site, não a API. Junte as entradas de /sitemap às páginas do site.
  • A chave não é o login do portal: trocar a senha não derruba o blog. Revogar a chave no portal corta a leitura na hora, até o site receber uma chave nova.
  • O post chega em HTML; o estilo é o do seu site.

Outras integrações

  • WordPress

    Usuário e senha de aplicativo, sem plugin: o passo a passo no WordPress.

  • Wix

    ID do site, ID de membro e chave de API: o passo a passo no Wix.

  • Todas as integrações

    WordPress, Wix e API lado a lado: o que cada uma pede e o que chega.

  • Preços

    4 posts grátis para testar; depois, R$ 297/mês ou R$ 2.970/ano.

Publicar meus 4 posts grátis

Sem cartão · 4 posts no total, em 1 site

Dúvidas do desenvolvedor.

  • Não. O site lê os posts pela API de conteúdo e monta as páginas do jeito dele, sem WordPress e sem plugin.

  • Não. Guarde a chave numa variável de ambiente do servidor e faça as leituras de lá. No navegador, qualquer visitante poderia ver a chave.

  • A chave inteira não fica salva no portal. Se ela ainda estiver no servidor do site, cole no portal para testar de novo; se não, gere outra e revogue a antiga.

  • Pelo sitemap.xml do seu site. A rota /sitemap devolve o caminho e a data de cada post; o desenvolvedor junta essas entradas às páginas do site.

  • Cada post tem um idioma. A lista filtra por idioma, e o post traz o slug das versões em outros idiomas, quando existem, para o hreflang.

API de conteúdo do BlogPost para sites com desenvolvedor