Limiti di frequenza dell'API

Token bucket per chiave

Ogni chiave API ha un token bucket con una raffica di 60 token e una velocità di ricarica di 1 token al secondo. Le letture costano 1 token. Le scritture costano 2 token.

Creare una notifica di aggiornamento prodotto (POST /products/{shopify_product_id}/notifications, dry run incluso) costa 10 token. Il flag notify_customers su una scrittura di mappatura non aggiunge nulla: quella scrittura costa i soliti 2 token, che chieda o meno una notifica. Il limite di 7 giorni di una notifica per prodotto è una regola separata con un proprio codice, 429 notification_cooldown: il suo Retry-After può arrivare a sette giorni, quindi non riprovare automaticamente — pianifica la chiamata successiva a error.details.next_available_at.

Un negozio può inoltre avere al massimo 5 notifiche di aggiornamento prodotto in coda o in invio contemporaneamente. Una sesta è 429 too_many_active_notifications, un terzo tipo di 429 accanto a rate_limited e notification_cooldown, quindi distinguili tramite error.code, non tramite il codice di stato. Non ha alcun Retry-After: interroga GET /notifications/{id} per uno degli error.details.active_notification_ids e riprova quando quella campagna sarà terminata.

Quando il limite viene superato, l'API restituisce 429 rate_limited.

Header dei limiti di frequenza

Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2026-06-05T12:00:00.000Z

Attendi almeno la durata indicata in Retry-After prima di riprovare. Riutilizza la stessa Idempotency-Key quando ripeti la stessa scrittura.

Limite di reinvio delle email

L'endpoint di reinvio degli ordini ha un limite di sicurezza aggiuntivo per ordine di 3 richieste di reinvio all'ora.