Credenciais e ambientes#
Configure as credenciais do Visualizer SDK para a sua loja virtual e, se necessário, para a Product Import API. A leitura da documentação pública não cria credenciais nem concede acesso a uma loja.
Qual credencial pertence a qual local?#
| Integração | Credencial | Onde pertence |
|---|---|---|
| SDK da storefront | Shop ID e Publishable Key | Atributos de script do SDK da storefront |
| Product Import API | Client ID e Client Secret | Seu backend ou um job seguro do lado do servidor |
Um Publishable Key é destinado ao navegador. Um Client Secret deve permanecer no seu servidor. Nunca cole-os em um theme, Markdown público, bundle do cliente ou screenshot de suporte.
Obtenha e configure as credenciais#
Abra o painel do comerciante, selecione a loja correta e confira a integração e as configurações do SDK. Siga as instruções de integração para Client ID e Client Secret.
Configurar Allowed Origins (CORS)#
Antes de testar ou publicar o SDK, abra Dashboard → Settings para a shop correta e localize Allowed Origins (CORS).
- Insira as origens das storefronts que carregarão o SDK, separadas por vírgulas. Por exemplo:
https://example.com, https://www.example.com, https://shop.example.com. - Use o protocolo e o hostname, mais a porta quando aplicável, sem caminho de página, query string ou fragment. Adicione também sua origem de preview ou staging se testar o SDK lá; use
http://localhost:3000apenas quando essa for sua origem real de teste local. - Clique em Save, recarregue a storefront e teste o SDK novamente.
Verifique a URL real que os clientes visitam: https://example.com e https://www.example.com são origens diferentes. Um teste local ou de preview bem-sucedido não garante que a origem publicada esteja configurada.
Substitua os valores de exemplo#
Os exemplos usam placeholders como <SHOP_ID>, <PUBLISHABLE_KEY> e <YOUR_CLIENT_SECRET>. Substitua-os apenas no ambiente pretendido. Exemplos HTML podem codificar colchetes angulares como < e >; substitua todo o placeholder, incluindo essa codificação.
Ambientes do SDK e da importação de produtos#
O navegador carrega https://sdk.ideal.house/sdk.js com o Shop ID e o Publishable Key da mesma shop. A Product Import API continua a usar https://sdkapi.ideal.house, com sua autenticação server-side documentada.
Configure as origens das storefronts de preview e produção separadamente, conforme descrito acima. Use produtos de teste preparados antes de publicar e, em seguida, conclua a checklist de lançamento.