REST API

O que é uma REST API?

Uma REST API é uma interface web construída sob o estilo arquitetural REST (Representational State Transfer), onde dois sistemas trocam dados via HTTP. Cada recurso — como um produto ou um pedido — possui sua própria URL, e você trabalha com ele por meio dos métodos padrão GET, POST, PUT e DELETE. As respostas são quase sempre entregues em formato JSON. O REST é stateless (sem estado): cada requisição contém tudo o que o servidor precisa e nenhuma sessão é armazenada entre as chamadas.

Por que uma REST API é importante?

Uma REST API é a cola entre sua loja e os sistemas ao seu redor: ERP, estoque, PIM, plataformas de e-mail e contabilidade. Em vez de exportação e importação manuais, os dados podem ser sincronizados automaticamente para que o estoque, os preços e os pedidos permaneçam consistentes entre as plataformas. Uma integração bem projetada reduz erros e trabalho manual — enquanto um fluxo de API mal estruturado pode atingir limites de taxa ou criar conflitos de dados.

Casos de uso comuns

• Sincronização de estoque e preços entre o Shopify e um sistema de ERP ou depósito.
• Criação ou atualização automática de produtos a partir de um feed de produtos.
• Exportação de pedidos para a contabilidade ou sistema de envio.
• Consulta de dados de clientes ou pedidos a partir de um aplicativo externo ou painel administrativo.
• Recebimento de eventos via webhooks para evitar a consulta constante (polling) à API.

Perspectiva do Shopify

O Shopify tornou a API Admin do GraphQL sua API principal, e a API Admin do REST está agora em modo de manutenção — desde 1º de abril de 2025, todos os novos aplicativos públicos devem ser desenvolvidos com GraphQL. Portanto, prefira o GraphQL para novas integrações. Independentemente do protocolo, as chamadas têm limite de taxa baseado em balde furado (leaky bucket, com limite de 40 requisições nos planos padrão), então estruture seu código para respeitar os limites e use webhooks em vez de consultas frequentes.