Se você precisa integrar a Wake Commerce com ERP, CRM, marketplace ou qualquer outro sistema, o caminho mais comum começa pela API de integração.
API (Interface de Programação de Aplicações) funciona como uma “ponte” entre sistemas: ela permite troca de dados de forma segura, reduz tarefas manuais e ajuda a automatizar processos como catálogo, pedidos, pagamentos e rotinas operacionais.
Neste tutorial, você vai entender quais APIs a Wake oferece, quando usar cada uma, e como criar e testar um token de segurança para começar uma integração do jeito certo.
O que dá para integrar com a API da Wake Commerce
Na prática, as APIs da Wake permitem conectar a plataforma a diferentes ferramentas do ecossistema digital, por exemplo:
- ERPs (faturamento, estoque, cadastro de produtos)
- CRMs (clientes, relacionamento e segmentação)
- Marketplaces (sincronização de catálogo e pedidos)
- Ferramentas internas ou sistemas legados
- Aplicações customizadas (apps, painéis, experiências personalizadas)
Quais são os tipos de API na Wake Commerce
A Wake trabalha com três frentes principais de API, cada uma com um objetivo:
1) API Pública
Indicada para integrações genéricas com sistemas externos, com padrão mais “universal” de uso.
2) API Custom
Ideal quando a operação precisa de adaptações e personalizações conforme a regra do seu negócio.
3) Store Front API
Focada em experiências personalizadas no front, como:
- aplicativos
- interfaces customizadas
- jornadas específicas de navegação/compra
Como criar um token de segurança na Wake (API Pública)
Para usar as APIs públicas, você precisa gerar um token de segurança, que funciona como uma chave com permissões controladas (ou seja: define o que a integração pode ou não acessar).
Siga o passo a passo:
- No painel, acesse Configurações
- Entre em Integrações
- Clique em Tokens
- Selecione Adicionar token
- Preencha:
- Nome da aplicação (ex.: “ERP”)
- Tipo de integração
- Responsável técnico
- Defina as permissões do token
- Exemplo: liberar acesso a formas de pagamento
- Clique em Salvar
Depois disso, o token aparece na lista e pode ser compartilhado com:
- sua equipe de desenvolvimento
- suporte técnico do ERP
- parceiros responsáveis pela integração
Como testar o token no portal de desenvolvedores
Com o token criado, é boa prática testar a autenticação antes de avançar com qualquer desenvolvimento.
O fluxo de teste, de forma geral, é:
- Acesse o portal de desenvolvedores da Wake Commerce
- Vá até Referências de API
- Selecione um endpoint de teste (por exemplo, um que retorne lista/dados)
- No painel à direita, cole o token em Credenciais / Header
- Execute o teste em Try it
Como validar se deu certo
- O retorno esperado é HTTP 200, indicando que a autenticação funcionou.
- Se vier outro código:
- revise se o token foi inserido corretamente no header
- confira se as permissões atribuídas ao token cobrem o recurso acessado
Limite de requisições da Wake: atenção ao rate limit
A Wake aplica um limite de 120 requisições por minuto por token.
Isso ajuda a manter a plataforma estável, especialmente em picos de uso. Na prática, essa informação é importante para:
- dimensionar integrações
- evitar bloqueios por excesso de chamadas
- planejar filas, cache e rotinas de sincronização
Boas práticas rápidas para integrações mais seguras
Antes de encerrar, vale guardar estas regras simples:
- Crie 1 token por aplicação (ERP, HUB, serviço interno etc.)
- Dê apenas as permissões necessárias (princípio do menor privilégio)
- Documente onde o token está sendo usado
- Revise permissões quando mudar o escopo da integração
- Monitore erros de autenticação e limites de requisição
Precisa integrar a Wake Commerce com seu ecossistema?
A Proex Digital atua como parceira certificada Wake Commerce, apoiando projetos de implantação, evolução e suporte incluindo integrações via API com ERPs, CRMs, marketplaces e soluções sob medida.
Se você quer acelerar o projeto com segurança (sem retrabalho em permissões, autenticação e arquitetura), fale com a Proex.
