Escolhendo a API certa
Escolhendo a API certa
Wake Commerce tem duas APIs independentes para contextos diferentes. Escolha pelo que você precisa construir — não pela tecnologia.
Desenvolvedor de storefront
Quando usar: você está construindo ou customizando o template da loja — páginas, checkout, minha conta, carrinho.
APIs: Wake Storefront + Storefront API (GraphQL)
Use essa combinação para renderizar produtos, criar e gerenciar carrinho, autenticar clientes, processar o checkout e personalizar a experiência do usuário final dentro da loja.
Integração ERP / backend
Quando usar: você está sincronizando produtos, pedidos ou usuários entre Wake e um sistema externo (ERP, OMS, WMS).
APIs: API Pública (REST) + Webhook
Use essa combinação para criar e atualizar produtos em massa, importar pedidos, controlar estoque, gerenciar usuários e receber notificações em tempo real de eventos da loja.
Integração de pagamentos
Quando usar: você está conectando um gateway ou adquirente à plataforma como conector de pagamento customizado.
APIs: Conector de Pagamento Customizado (Pagamentos)
Wake envia os dados do pedido ao seu endpoint. Você responde com o resultado da transação. O contrato cobre tokenização, autorização, captura, cancelamento e chargeback.
Dados e analytics
Quando usar: você quer consumir dados da loja em ferramentas de BI ou montar dashboards externos.
APIs: DATA WAKE
Acesso a dados de vendas, produtos, pedidos e clientes para conectar ao Power BI ou outras ferramentas de visualização.
Storefront API vs API Pública
Não sabe qual das duas usar? A tabela abaixo resume as principais diferenças.
| Storefront API | API Pública | |
|---|---|---|
| Protocolo | GraphQL | REST |
| Quem autentica | Cliente ou parceiro da loja | Sistema backend (token técnico) |
| Leitura de dados | Sim | Sim |
| Escrita por cliente final | Sim (carrinho, pedido) | Não |
| Gestão de catálogo | Não | Sim |
| Uso típico | Dentro do storefront | Servidor para servidor |
Updated about 9 hours ago

