Limites de taxa

Para manter a plataforma rápida e confiável para todos, a API REST do SIP Caller limita o número de solicitações que cada chave de API pode fazer.

Limites

Cada chave de API pode fazer até 20 solicitações por segundo, em média.

O limite se aplica a cada chave de API separadamente. Todas as solicitações contam para o limite, incluindo as que falham.

Solicitar um limite maior

Se sua integração precisar de um limite maior, entre em contato conosco e explique seu caso de uso: o que sua integração faz, quantas solicitações ela envia, e como elas se distribuem ao longo do tempo. Analisaremos o caso e ajudaremos você a encontrar a melhor solução, que pode incluir o aumento do limite para a sua conta.

Exceder o limite

Quando o limite é excedido, a API retorna um erro 429 Too Many Requests, com um cabeçalho Retry-After que indica o número de segundos a aguardar antes de enviar mais solicitações:

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"
}

Boas práticas

• Respeite o cabeçalho Retry-After. Quando receber um erro 429, aguarde pelo menos o número de segundos indicado antes de tentar novamente.
• Use endpoints em massa. A maioria das operações aceita muitos registros em uma única solicitação. Por exemplo, adicione centenas de números a uma campanha em uma única solicitação Adicionar números, em vez de uma solicitação por número, ou envie um arquivo CSV.
• Use webhooks em vez de polling. Em vez de verificar alterações a cada poucos segundos, assine os webhooks para ser notificado quando as campanhas mudarem de estado ou as chamadas terminarem.
• Use páginas maiores. Ao ler listas longas, solicite páginas de algumas centenas de registros em vez de páginas pequenas. Consulte Paginação.
• Distribua os processos em lote. Se um processo envia muitas solicitações, adicione um pequeno intervalo entre elas, em vez de enviá-las todas de uma vez.