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 APIAPI Pública
ProtocoloGraphQLREST
Quem autenticaCliente ou parceiro da lojaSistema backend (token técnico)
Leitura de dadosSimSim
Escrita por cliente finalSim (carrinho, pedido)Não
Gestão de catálogoNãoSim
Uso típicoDentro do storefrontServidor para servidor
📘

Regra geral: se o código roda no navegador do cliente ou no template da loja, use a Storefront API. Se roda no seu servidor para sincronizar dados com Wake, use a API Pública.