Limites de débit
Pour que la plateforme reste rapide et fiable pour tous, l’API REST de SIP Caller limite le nombre de requêtes que chaque clé API peut effectuer.
Limites
Chaque clé API peut effectuer jusqu’à 20 requêtes par seconde, en moyenne.
La limite s’applique à chaque clé API séparément. Toutes les requêtes sont prises en compte dans la limite, y compris celles qui échouent.
Demander une limite plus élevée
Si votre intégration a besoin d’une limite plus élevée, contactez-nous et expliquez votre cas d’usage : ce que fait votre intégration, combien de requêtes elle envoie, et comment elles sont réparties dans le temps. Nous l’étudierons et vous aiderons à trouver la meilleure solution, qui peut inclure l’augmentation de la limite pour votre compte.
Dépassement de la limite
Lorsque la limite est dépassée, l’API renvoie une erreur 429 Too Many Requests, avec un en-tête Retry-After indiquant le nombre de secondes à attendre avant d’envoyer d’autres requêtes :
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"
}Bonnes pratiques
- Respectez l’en-tête
Retry-After. Lorsque vous recevez une erreur429, attendez au moins le nombre de secondes indiqué avant de réessayer. - Utilisez les points de terminaison en masse. La plupart des opérations acceptent de nombreux enregistrements en une seule requête. Par exemple, ajoutez des centaines de numéros à une campagne en une seule requête Ajouter des numéros, au lieu d’une requête par numéro, ou téléversez un fichier CSV.
- Utilisez les webhooks plutôt que l’interrogation périodique. Au lieu de vérifier les changements toutes les quelques secondes, abonnez-vous aux webhooks pour être notifié lorsque les campagnes changent d’état ou que les appels se terminent.
- Utilisez des pages plus grandes. Lorsque vous lisez de longues listes, demandez des pages de quelques centaines d’enregistrements plutôt que de petites pages. Consultez Pagination.
- Étalez les traitements par lots. Si un traitement envoie de nombreuses requêtes, ajoutez un court délai entre elles, au lieu de les envoyer toutes en même temps.
