L'Admin API e i webhook nella pratica
Le integrazioni con Shopify sono principalmente due meccanismi: l'Admin API, che chiami per leggere e scrivere, e i webhook, che ti chiamano quando succede qualcosa.
Entrambi sono semplici. Ciò che separa un'integrazione affidabile da una instabile è come gestisci i casi in cui si comportano male — e lo faranno.
I due meccanismi#
| Admin API | Webhook | |
|---|---|---|
| Direzione | Tu chiami Shopify | Shopify chiama te |
| Buono per | Leggere stato, scrivere modifiche, backfill | Reagire agli eventi prontamente |
| Modalità di fallimento | Limiti di rate, cambiamenti di versione | Duplicati, consegna fuori ordine, eventi persi |
| Deve gestire | Retry e paginazione | Idempotenza e verifica |
Regole che rendono le integrazioni affidabili#
- Verifica ogni firma webhook prima di fidarti del payload. Gli endpoint non verificati sono una porta aperta.
- Rendi ogni handler idempotente — lo stesso evento arriverà due volte alla fine.
- Non presumere l'ordine. Una cancellazione può arrivare prima della creazione che stavi aspettando.
- Rispondi rapidamente e processa in modo asincrono; gli endpoint lenti vengono ritentati e poi disabilitati.
- Riconcilia quotidianamente con l'API. I webhook perdono eventi; una scansione notturna cattura ciò che è sfuggito.
I limiti di rate sono un input di progettazione#
Shopify misura l'accesso API. Non è un ostacolo da aggirare con i retry; è un vincolo per cui progettare. Letture batch, richiedi solo i campi di cui hai bisogno e usa operazioni bulk per i backfill invece di camminare ogni prodotto una chiamata alla volta.
Se la tua integrazione funziona solo quando nient'altro è in esecuzione, non funziona. Testala mentre è in corso un'importazione.
Versionamento#
Le versioni API sono datate e scadono. Metti l'aggiornamento nel calendario piuttosto che scoprirlo attraverso un fallimento. Una piccola integrazione richiede un'ora per andare avanti; una che ha saltato quattro versioni richiede una settimana.
Domande frequenti
Webhook o polling?
Webhook per prontezza, una riconciliazione periodica per correttezza. Le integrazioni più affidabili usano entrambi.
Come fermo l'elaborazione duplicata?
Memorizza l'identificatore dell'evento e ignora le ripetizioni. L'idempotenza è l'abitudine più preziosa qui.
Cosa si rompe per primo su scala?
I limiti di rate, di solito durante un backfill che cammina i record uno alla volta invece di usare operazioni bulk.
shopify admin apiwebhook shopifyintegrazione shopifylimiti rate api shopifyshopify graphql api
