Limiti di frequenza dell'API

L'API è progettata per un traffico di integrazione da basso a moderato. Distribuisci nel tempo le importazioni a raffica e rispetta Retry-After quando l'API ti chiede di rallentare.

Ultimo aggiornamento - 5 giugno 2026 Tempo di lettura - 3 min Autore - Tom Rushmore

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.

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.

Documentazione API

Inizia qui

Quickstart API

Esegui un ping all'API, importa un asset, mappalo a un prodotto e assegna l'accesso a un ordine.

Riferimento

Riferimento degli endpoint

Consulta gli endpoint disponibili per asset, mappature, ordini, modifiche di accesso e stato.

È stato utile?

Ancora bloccato? Scrivi a admin@alvaapps.com.

Ultimo aggiornamento 2026-06-05