Centro risoluzione errori

Shopify REST Admin API 429 e Retry-After: gestione dei limiti di richiesta

Il significato della risposta Shopify REST Admin API 429, l'uso dell'header Retry-After e la progettazione delle code di integrazione.

Codariva ·

Le chiamate alla REST Admin API di Shopify possono essere limitate in alcuni casi con la risposta 429 Too Many Requests. Questa pagina riguarda in particolare le integrazioni esistenti/legacy che usano REST Admin API; Shopify consiglia GraphQL Admin API per le nuove integrazioni.

Cosa indica Retry-After?

Secondo la documentazione Shopify REST Admin API, al superamento del limite può essere restituito, insieme alla risposta 429, l'header Retry-After. Questo header indica il tempo da attendere prima di effettuare una nuova chiamata. Molti tentativi simultanei possono far crescere ulteriormente la coda di attesa.

Cosa fare?

  • Monitora endpoint, negozio e codice di risposta per ogni richiesta.
  • Se presente nella risposta API, considera il valore di Retry-After .
  • Organizza le attività in una coda equa; valuta una gestione del traffico distinta per ogni negozio.
  • Impedisci che i nuovi tentativi generino ordini o record duplicati.
  • Pianifica i trasferimenti massivi nei periodi meno intensi e valuta pattern API più adatti.

Errore architetturale frequente

In un'integrazione ERP–e-commerce, inviare frequentemente una chiamata API separata per ogni SKU può generare carico inutile. Individuare i record da aggiornare, raggruppare le modifiche e usare i metodi efficienti supportati dalle risorse può essere più sostenibile.

Test della prevenzione

Quando il limite viene superato, non deve essere mostrato un falso messaggio di successo. Il team operativo deve vedere il ritardo della coda, l'ultima sincronizzazione riuscita e il numero di operazioni in attesa.

Come interpretare la risposta di esempio?

La risposta rappresentativa seguente indica che il negozio e l'applicazione hanno raggiunto il limite di richieste. Non si pianifica un nuovo tentativo prima della fine dell'attesa; si considerano anche le altre attività che nel frattempo operano sullo stesso negozio.

HTTP 429 Too Many Requests
Retry-After: 2.0
X-Shopify-Shop-Api-Call-Limit: 40/40

Questi numeri sono esemplificativi, non quote fisse valide per ogni piano del negozio. Documentazione sui rate limit di Shopify.

Situazione Approccio da applicare
Retry-After valido Non riprovare prima dell'intervallo indicato
Header mancante/non valido Usa la tua politica di attesa limitata e indaga la causa
429 persistente Riduci il carico e il perimetro del trasferimento; fermati quando esaurisci il budget di tentativi

Per i nuovi progetti va valutato l'attuale approccio GraphQL Admin API al posto di REST; i suoi limiti di costo e di query non coincidono con il modello REST basato sul numero di richieste. Questa guida non va utilizzata come soluzione per gli errori GraphQL.

Quando chiedere supporto all'amministratore?

Se il problema persiste pur rispettando Retry-After e i limiti di applicazione/negozio, valuta insieme worker e code che usano lo stesso negozio. Fornisci all'assistenza l'identificativo della richiesta depurato, l'orario e gli header dei limiti; non condividere il token di accesso. Per le scritture in attesa, riconcilia prima i record già accettati.

Fonti e verifica

I flussi esemplificativi sono proposte architetturali, non progetti cliente completati né dichiarazioni di partnership con i produttori. Verifica delle fonti tecniche: 17 ottobre 2026. Versione, licenza e autorizzazioni dell'installazione vanno verificate separatamente.

Adatta il flusso alla tua azienda

Consulta la guida alla pianificazione dell'integrazione ERP. Puoi approfondire il perimetro previsto per lo sviluppo software su misura; possiamo valutare insieme il tuo processo attuale.

Parliamo delle tue esigenze →