Integração com Sites (API e WordPress)

"Aplica-se a: Studio Pro, Guardian Pro, Galleria Pro" "Keyword: integracao site wordpress plugin api" "Title: Como integrar o Acervo Vivo ao seu Site | Central de Ajuda - Acervo Vivo" "Meta: Aprenda a exibir seu acervo automaticamente no seu site usando o plugin Acervo Vivo Sync para WordPress ou a nossa API Headless pública." "Slug: integracao-de-sites" "Alt-Capa: Ilustração mostrando a conexão da plataforma Acervo Vivo com um site externo" "HelpContext: settings-sistemas"

1. O que é este módulo?

A integração permite que você envie as obras, exposições e textos da sua curadoria pública diretamente para o seu site oficial. Em vez de recadastrar imagens e dados manualmente em dois lugares diferentes, o Acervo Vivo atua como a única fonte da verdade, atualizando o seu portfólio na web de forma automatizada e com Soberania Digital.

2. Como acessar

No menu lateral, clique em Configurações → aba Sistemas.

Role até a seção Integração com um Site via API (exibida em formato de duas colunas) e marque a opção Ativar a sincronização com o site. Assim que ativada, a sua chave de conexão única (Chave da API Headless CMS) será exibida na coluna da direita com um botão para cópia imediata.

3. Como usar

Existem duas formas de levar o seu Acervo Vivo para o seu site, dependendo da tecnologia que o seu web designer ou desenvolvedor utiliza:

Opção A: O Plugin para WordPress (Acervo Vivo Sync)

Se o seu site foi construído em WordPress, nós fornecemos um plugin oficial "Plug and Play".

1. Instalação: Instale o arquivo .zip do Acervo Vivo Sync no seu painel do WordPress.
2. Conexão: Vá nas configurações do plugin e cole a sua Chave da API (fornecida na nossa aba de Sistemas).
3. Mágica do Sideload: O plugin não usa links temporários. Ele faz o download físico (Asset Mirroring) das fotos das obras em alta resolução direto para a Biblioteca de Mídia do seu próprio servidor, garantindo que o seu site nunca fique com "imagens quebradas".
4. Tempo Real: Com a tecnologia de Webhook, se você marcar uma obra como "Vendida" no Acervo Vivo, o site em WordPress é avisado e atualizado instantaneamente.
5. Exibição: O seu desenvolvedor só precisará colar os shortcodes (como [acervo_grade tipo="obras"] ou [acervo_grade tipo="exposicoes"]) nas páginas para exibir as vitrines perfeitamente formatadas.

Opção B: Consumo Direto da API Headless (Next.js, React, etc)

Se o seu site for programado do zero por uma agência (utilizando arquiteturas modernas como Next.js ou Vue), eles podem consumir os seus dados diretamente.

1. Endpoint Público: Forneça ao seu programador o endereço https://app.acervovivo.com/api/v1/public/sandbox?apiId=SUA_CHAVE_AQUI.
2. O Filtro da Vitrine: A API não expõe todo o seu acervo. Para que uma obra, evento ou texto apareça no seu site, é obrigatório vinculá-lo a uma Palavra-chave do tipo "🌐 Site/Ecommerce".
3. Blindagem de Dados: O sistema possui um "Escudo de Dados". O seu site receberá um JSON super limpo com as imagens de capa, carrossel de detalhes, títulos e dimensões. Dados sensíveis (como contatos de compradores, valores de aquisição e notas logísticas ocultas) são sumariamente cortados pelo servidor e nunca trafegam para a internet pública.