Visão geral
Os limites de concorrência asseguram uma utilização justa e a estabilidade da API. O número de tarefas que podem ser executadas em simultâneo depende do seu plano.Limites por plano
O seu plano determina a sua concorrência, que é definida por modelo e contabilizada por utilizador. Os planos de nível superior podem executar mais tarefas em simultâneo.Contacte a equipa de vendas para obter detalhes do plano Enterprise e configurações de concorrência personalizadas.
Backlog de tarefas
Quando o backlog está disponível, as tarefas que submete acima do seu limite de concorrência são aceites comstatus: "backlogged". Começam, pela ordem em que foram submetidas, à medida que as tarefas em execução terminam. Não existe um limite separado para o backlog.
Quando o backlog não está disponível, uma tarefa adicional pode ser rejeitada com HTTP 429 em vez de ser colocada em fila. O limite é aproximado: um pico curto de pedidos pode ainda ser aceite acima dele. Perante um 429, repita o pedido com backoff depois de as tarefas em curso terminarem. O corpo e os cabeçalhos da resposta estão descritos em Erros e depuração.
Boas práticas
- Implementar backoff exponencial - Espere progressivamente mais tempo entre novas tentativas
- Colocar pedidos em fila do lado do cliente - Um pico de pedidos pode ser aceite acima do limite, por isso não conte com a API para travar o pedido seguinte
- Monitorizar a sua utilização - Acompanhe as contagens de pedidos para se manter dentro dos limites
- Usar webhooks - Reduza os pedidos de polling recorrendo a webhooks para a conclusão de tarefas
Próximos passos
Chaves de API e faturação
Monitorize a utilização e as métricas da sua API
Webhooks
Reduza o polling usando webhooks
Erros e depuração
Corpos de resposta 429, backoff e códigos de tarefas falhadas