SPREEAI/Desenvolvedores/Documentário

Construindo com
SPREEAI.

A practical path from integration choice to a tested launch. Start with one commerce journey, use issued test access and keep credentials out of browser code.

Guia PúblicaWeb SDK v2.1Atualizado em agosto de 2026

Escolha o caminho de integração

CaminhoMelhor paraPrimeira ação
Aplicativo ShopifyInstalação de frente de loja gerenciada rapidamenteInstale a app
SDK WebWeb personalizada ou sem cabeçalhoLeia o guia do SDK
iOS / AndroidApps de compras nativasEscolha um guia nativo
APIs PúblicoFluxos de trabalho do lado do servidor aprovadosReferência aberta aprovada
Amazon Rede de ParceirosIntegração de MercadoChegando em breve
Segurança de credenciais. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Aplicativo Shopify

Use the managed app when the store runs on Shopify and does not need a custom backend. The current onboarding flow connects the store after agreements and subscription; it does not require copying API keys into the setup screen.

  1. Instale o oficial SPREEAI aplicando e completando o fluxo de consentimento gerenciado.
  2. Sincronize um grupo de catálogo inicial e revise os estados de disponibilidade do produto.
  3. Personalize a colocação e o estilo em um tema duplicado.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Publica-se somente após a marca e aprovação QA.

Abre a guia oficial de embarque Shopify

Web SDK em breve

Usando @ spreeai Web-Sdk em para colocação personalizada, estilagem, eventos, tamanho e comportamento de carro.

npm install @spreeai/web-sdk

import { init } from "@spreeai/web-sdk";

const sdk = await init({
  clientId: "your-client-id",
  partnerId: "your-partner-id"
});

sdk.renderTryOnButton({
  selector: "#spreeai-try-on",
  productId: product.id,
  enableAddToCart: true
});

Initialize once, render only for an eligible product and connect documented client callbacks to your existing analytics. Confirm the current interface in the Referência oficial do Web SDK API

API de acesso

Use the public Swagger reference only for server-side workflows approved during onboarding. Keep secrets on your server, separate test and production access, and scope credentials to the minimum required environment.

Direct REST endpoints, webhooks or authentication behaviors not present in the approved public reference should be treated as unavailable until Partner Engineering confirms them.

Abre a referência API pública aprovada

Avaliação de ativos base

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Um vestido por imagem, centrado com bordas limpas e neutras, mesmo iluminação.
  • Exige vista de frente; a vista de trás é recomendada quando essa experiência é ativada.
  • Stable SKU, style or garment ID included in the filename and catalogue record.
  • No hands, hangers, styling props, watermarks or unrelated garments blocking the item.
  • A variante de mapeamento foi verificada antes de permitir a experiência.

QA e lançamento

  • Teste a jornada completa do cliente em navegadores móveis e de desktop atuais.
  • Verifique o produto e a variante de mapeamento, a preparação do vestido e o comportamento da cesta.
  • Verifique o acesso ao teclado, a ordem de foco, os nomes acessíveis e o comportamento de queda.
  • Medir o desempenho da página do produto antes e depois de permitir SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Confirmar o idioma de consentimento e a manipulação aprovada da imagem do cliente.
  • Obtenha engenharia, comércio, QA e marca de sinal antes da produção.

Resolução de problemas

O botão não aparece

Confirm SDK initialization, client and partner identifiers, the target selector, product eligibility, garment readiness and variant mapping. Then check browser console and network errors without sharing tokens.

O produto ou a variante errada aparece

Compare o produto e os IDs de variante do Storefront com os registros enviados para SPREEAI. Confirme que a solicitação feita muda quando o comprador muda as variantes.

A experiência é lenta ou inacessível

Test a known-ready product, verify the active environment, inspect blocked requests and compare a clean browser session. Capture a timestamp and reproducible sequence for support.

Obtenha apoio de desenvolvedores

E-mail support@spreeai.com com o ambiente, produto ou ID de roupa, navegador ou vic e, tempo aproximado, comportamento esperado e etapas de reprodução. Não inclua segredos ou imagens de clientes.

Escolha a sua língua.