Panoramica
I limiti di concorrenza garantiscono un utilizzo equo e la stabilità della API. Il numero di job che possono essere eseguiti contemporaneamente dipende dal tuo piano.Limiti per piano
Il tuo piano determina la concorrenza, che è impostata per modello e conteggiata per utente. I piani di livello superiore possono eseguire più job contemporaneamente.Contatta il team commerciale per i dettagli del piano Enterprise e per una concorrenza personalizzata.
Job backlog
Quando il backlog è disponibile, i job inviati oltre il tuo limite di concorrenza vengono accettati constatus: "backlogged". Partono, nell’ordine di invio, man mano che i job in esecuzione terminano. Non esiste un limite separato per il backlog.
Quando il backlog non è disponibile, un job aggiuntivo può essere rifiutato con HTTP 429 invece di essere messo in coda. Il limite è approssimativo: un breve picco può comunque essere accettato oltre il limite. In caso di 429, riprova con backoff dopo che i job in corso sono terminati. Il body e gli header sono descritti in Errori e debugging.
Buone pratiche
- Implementa un backoff esponenziale — Attendi progressivamente più a lungo tra un tentativo e l’altro
- Metti in coda le richieste lato client — Un picco può essere accettato oltre il limite, quindi non affidarti alla API per bloccare la richiesta successiva
- Monitora il tuo utilizzo — Traccia il numero di richieste per restare entro i limiti
- Usa i webhook — Riduci le richieste di polling utilizzando i webhook per il completamento dei job
Prossimi passi
Chiavi API e fatturazione
Monitora l’utilizzo e le metriche della tua API
Webhook
Riduci il polling utilizzando i webhook
Errori e debugging
Body dei 429, backoff e codici dei job falliti