Limiti di frequenza
Per mantenere la piattaforma veloce e affidabile per tutti, la REST API di SIP Caller limita il numero di richieste che ogni API Key può effettuare.
Limiti
Ogni API Key può effettuare fino a 20 richieste al secondo, in media.
Il limite si applica a ogni API Key separatamente. Tutte le richieste concorrono al limite, comprese quelle che falliscono.
Richiedere un limite più alto
Se la tua integrazione ha bisogno di un limite più alto, contattaci e spiega il tuo caso d'uso: cosa fa la tua integrazione, quante richieste invia e come sono distribuite nel tempo. Lo valuteremo e ti aiuteremo a trovare la soluzione migliore, che può includere l'aumento del limite per il tuo account.
Superamento del limite
Quando il limite viene superato, l'API restituisce un errore 429 Too Many Requests, con un'intestazione Retry-After che indica il numero di secondi da attendere prima di inviare altre richieste:
HTTP/1.1 429 Too Many Requests
Retry-After: 5{
"type": "https://tools.ietf.org/html/rfc6585#section-4",
"title": "One or more errors occurred.",
"status": 429,
"detail": "Too many requests. Retry after 5 seconds.",
"instance": "/v1/accounts/ACCOUNT_ID/campaigns",
"traceId": "0HN6QKQ1B2F3G:00000004"
}Buone pratiche
- Rispetta l'intestazione
Retry-After. Quando ricevi un errore429, attendi almeno il numero di secondi indicato prima di ritentare. - Usa gli endpoint per operazioni in blocco. La maggior parte delle operazioni accetta molti record in un'unica richiesta. Ad esempio, aggiungi centinaia di numeri a una campagna con una sola richiesta Aggiungere numeri, invece di una richiesta per ogni numero, oppure carica un file CSV.
- Usa i webhook invece del polling. Invece di verificare la presenza di modifiche ogni pochi secondi, iscriviti ai webhook per ricevere una notifica quando le campagne cambiano stato o le chiamate terminano.
- Usa pagine più grandi. Quando leggi elenchi lunghi, richiedi pagine di qualche centinaio di record invece di pagine piccole. Consulta Paginazione.
- Distribuisci i processi batch. Se un processo invia molte richieste, aggiungi un breve ritardo tra una richiesta e l'altra, invece di inviarle tutte insieme.
