Desenvolvedores: integrar o provador
Esta seção é para quem cuida do código da loja. Ela mostra os códigos de instalação da Provei, as opções para abrir o provador por um botão próprio, a API JavaScript do provador, os eventos que ele dispara, as variáveis de CSS e o que liberar numa política de segurança de conteúdo (CSP).
Para uma instalação comum, o assistente da tela Instalação basta. Veja Instalar a Provei na sua loja.
O que tem nesta seção
Seção intitulada “O que tem nesta seção”| Página | Para que serve |
|---|---|
| Modos de instalação | Os códigos de cada provador e as três formas de colocar o provador na página: botão automático, dentro da página e botão próprio da loja. |
| Carregador do provador de ambientes | O código recomendado para o provador de móveis, pisos e paredes, que confere a conta antes de carregar. |
| Código do Video Commerce | O script que carrega as vitrines de vídeo publicadas. |
| API JavaScript do provador | Abrir e fechar o provador pelo seu próprio código. |
| Eventos do provador | Saber quando o provador fica pronto, abre, fecha, adiciona ao carrinho ou dá erro. |
| Personalizar com CSS | As variáveis de CSS do botão e da janela. |
| CSP e domínios | Os endereços que uma política de segurança de conteúdo precisa permitir. |
| Lojas SPA e headless | Como o provador se comporta em sites que trocam de página sem recarregar. |
Integração por API
Seção intitulada “Integração por API”A referência pública de API está em revisão. Para integrações de servidor, fale com suporte@provei.ai.
Uma integração por API usa uma chave de API da sua conta. A chave é uma senha: ela fica só no servidor da loja, nunca no código do site, no tema ou em aplicativos. O código de instalação do provador não leva chave.
- Para criar, trocar e revogar chaves, veja Criar e revogar chaves de API.
- Para guardar as chaves com segurança, veja Boas práticas com chaves de API e acessos.
Antes de mexer no código
Seção intitulada “Antes de mexer no código”- Confira o identificador da conta. Todos os códigos usam o identificador da sua conta, no formato
00000000-0000-4000-8000-000000000000. Copie o código pronto na tela Instalação em vez de montar à mão. - Use um código por provador. Cada provador ativo na conta tem o seu código. Não coloque na mesma página códigos de contas diferentes.
- Prefira os ajustes do painel. Texto, cores, posição do botão, formato da janela e CSS próprio ficam em Experiência na loja. Mudanças ali não exigem mexer no tema.
Perguntas frequentes
O código de instalação precisa de chave de API?
Não. O código que vai no site da loja não leva chave de API. Chaves são só para sistemas que rodam no servidor da loja.
Existe uma API REST pública da Provei?
A referência pública da API está em revisão. Para integrar um sistema de servidor com a Provei, fale com suporte@provei.ai.
Por onde começo se só quero instalar o provador?
Use o assistente da tela Instalação do painel. Esta seção é para quem precisa de algo além do botão automático, como um botão próprio, eventos ou ajustes de CSS.