O Admin API e webhooks na prática
Integrações contra Shopify são maioritariamente dois mecanismos: o Admin API, que chama para ler e escrever, e webhooks, que o chamam quando algo acontece.
Ambos são diretos. O que separa uma integração fiável de uma instável é como lida com os casos em que se comportam mal — e vão comportar-se.
Os dois mecanismos#
| Admin API | Webhooks | |
|---|---|---|
| Direção | Você chama Shopify | Shopify chama-o |
| Bom para | Ler estado, escrever alterações, backfills | Reagir a eventos prontamente |
| Modo de falha | Limites de taxa, mudanças de versão | Duplicados, entrega fora de ordem, eventos perdidos |
| Tem de lidar com | Retries e paginação | Idempotência e verificação |
Regras que tornam integrações fiáveis#
- Verifique cada assinatura de webhook antes de confiar no payload. Endpoints não verificados são uma porta aberta.
- Torne cada handler idempotente — o mesmo evento chegará duas vezes eventualmente.
- Não assuma ordem. Um cancelamento pode chegar antes da criação que estava à espera.
- Retorne rapidamente e processe assincronamente; endpoints lentos são retriados e depois desativados.
- Reconcilie diariamente contra o API. Webhooks perdem eventos; uma varredura noturna apanha o que escapou.
Limites de taxa são um input de design#
Shopify mede o acesso ao API. Isso não é um obstáculo a contornar com retries; é uma restrição para a qual desenhar. Leituras em lote, peça apenas os campos que precisa, e use operações em massa para backfills em vez de percorrer cada produto uma chamada de cada vez.
Se a sua integração só funciona quando nada mais está a correr, não funciona. Teste-a enquanto uma importação está em progresso.
Versionamento#
As versões do API são datadas e expiram. Coloque a atualização no calendário em vez de a descobrir através de uma falha. Uma pequena integração leva uma hora a avançar; uma que saltou quatro versões leva uma semana.
Perguntas frequentes
Webhooks ou polling?
Webhooks para prontidão, uma reconciliação periódica para correção. A maioria das integrações fiáveis usa ambos.
Como paro o processamento duplicado?
Guarde o identificador do evento e ignore repetições. Idempotência é o hábito mais valioso aqui.
O que se parte primeiro em escala?
Limites de taxa, normalmente durante um backfill que percorre registos um de cada vez em vez de usar operações em massa.
shopify admin apishopify webhooksintegração shopifylimites taxa api shopifyshopify graphql api
