Documentação do SDK Wearix
Tudo o que você precisa para colocar o provador virtual no ar. Tempo médio: 10 minutos.
1. Prepare as imagens dos produtos
- Formato PNG com fundo transparente, peça vista de frente, centralizada.
- Roupas: recorte só a peça (sem manequim). Largura entre 800 e 1500 px.
- Óculos e bonés: recorte o acessório na posição em que é usado, visto de frente.
- Tamanho máximo 5 MB. Fotos com fundo dão resultado ruim.
2. Cadastre o produto no painel
Em Produtos → Novo, informe nome, SKU (o mesmo da sua loja) e a categoria. A categoria define o motor de AR: vestido, camiseta, jaqueta e calça usam rastreamento de corpo; óculos e boné usam rastreamento facial.
3. Instale o script
Antes do </body> das páginas de produto (ou no rodapé do tema):
<script src="https://wearix.ajsolutions.com.br/assets/js/wearix-sdk-simple.js"></script>
<script>
WearixAR.init({ apiKey: 'SUA_API_KEY' });
</script>
A API Key está no seu dashboard.
4. Adicione o botão
<button onclick="WearixAR.open('SKU-DO-PRODUTO')">👗 Experimentar com AR</button>
Você pode usar o ID numérico do produto no lugar do SKU. Opções: WearixAR.open(sku, { mode: 'redirect' }) abre em página inteira em vez de janela sobreposta.
5. Por plataforma
WooCommerce
Instale o script em Aparência → Personalizar → HTML adicional (ou pelo plugin "Insert Headers and Footers"). No template de produto, use o SKU do WooCommerce: WearixAR.open('<?php echo $product->get_sku(); ?>').
Shopify
Em Temas → Editar código → theme.liquid, cole o script antes de </body>. No product.liquid: WearixAR.open('{{ product.selected_or_first_available_variant.sku }}').
Nuvemshop, Tray, Loja Integrada
Use a área de "scripts personalizados" ou "HTML no rodapé" do tema e o campo de SKU do produto na variável do template. Se precisar, fale com a gente que fazemos a integração junto.
6. Como funciona a experiência
Ao clicar, o SDK consulta a API com sua chave, identifica a categoria e o dispositivo e abre o provador em uma janela sobre a sua página (iframe com permissão de câmera). O cliente permite a câmera, vê a peça sobre o corpo ou rosto, pode ajustar tamanho e posição, e fecha para continuar comprando. Cada abertura do provador conta como uma experimentação no limite do plano.
7. API
Endpoints JSON (POST, corpo {"api_key": "...", "product_id": "SKU"}), com CORS liberado:
/api/ar-config.php— motor e URL do provador para o produto./api/produto-dados.php— dados e imagem do produto./api/verificar-limite.php— uso do mês e limite do plano./api/registrar-uso.php— registra eventos (ar_open,try_on).
Códigos de erro: 400 parâmetros, 401 chave inválida, 403 assinatura inativa, 404 produto não encontrado, 429 limite do plano atingido.
8. Boas práticas
- Exija HTTPS na sua loja: a câmera só funciona em páginas seguras.
- Mostre o botão perto da foto principal do produto e explique em uma linha ("veja como fica em você").
- Teste no celular: é onde a maioria dos clientes vai usar.