L'Admin API et les webhooks en pratique
Les intégrations avec Shopify utilisent principalement deux mécanismes : l'Admin API, que vous appelez pour lire et écrire, et les webhooks, qui vous appellent quand quelque chose se produit.
Les deux sont simples. Ce qui sépare une intégration fiable d'une défaillante est la façon dont vous gérez les cas où ils se comportent mal — et ils le feront.
Les deux mécanismes#
| Admin API | Webhooks | |
|---|---|---|
| Direction | Vous appelez Shopify | Shopify vous appelle |
| Bon pour | Lire l'état, écrire des changements, remplissages | Réagir aux événements rapidement |
| Mode de défaillance | Limites de taux, changements de version | Doublons, livraison désordonnée, événements manqués |
| Doit gérer | Nouvelles tentatives et pagination | Idempotence et vérification |
Règles qui rendent les intégrations fiables#
- Vérifiez chaque signature de webhook avant de faire confiance à la charge utile. Les points de terminaison non vérifiés sont une porte ouverte.
- Rendez chaque gestionnaire idempotent — le même événement arrivera deux fois éventuellement.
- Ne supposez pas l'ordre. Une annulation peut arriver avant la création que vous attendiez.
- Retournez rapidement et traitez de manière asynchrone ; les points de terminaison lents sont réessayés puis désactivés.
- Réconciliez quotidiennement avec l'API. Les webhooks manquent des événements ; un balayage nocturne attrape ce qui a glissé.
Les limites de taux sont une donnée de conception#
Shopify mesure l'accès API. Ce n'est pas un obstacle à contourner avec des nouvelles tentatives ; c'est une contrainte pour laquelle concevoir. Regroupez les lectures, demandez uniquement les champs dont vous avez besoin, et utilisez les opérations en masse pour les remplissages au lieu de parcourir chaque produit un appel à la fois.
Si votre intégration ne fonctionne que quand rien d'autre ne tourne, elle ne fonctionne pas. Testez-la pendant qu'une importation est en cours.
Versionnage#
Les versions API sont datées et expirent. Mettez la mise à niveau au calendrier plutôt que de la découvrir par une défaillance. Une petite intégration prend une heure pour avancer ; une qui a sauté quatre versions prend une semaine.
Questions fréquentes
Webhooks ou interrogation ?
Webhooks pour la rapidité, une réconciliation périodique pour l'exactitude. Les intégrations les plus fiables utilisent les deux.
Comment arrêter le traitement en double ?
Stockez l'identifiant d'événement et ignorez les répétitions. L'idempotence est l'habitude la plus précieuse ici.
Qu'est-ce qui casse en premier à l'échelle ?
Les limites de taux, généralement pendant un remplissage qui parcourt les enregistrements un à la fois au lieu d'utiliser les opérations en masse.
shopify admin apiwebhooks shopifyintégration shopifylimites taux api shopifyshopify graphql api
