Publicado originalmente em 10 de fevereiro de 2020
O registro de limite de taxa de API está em vigor desde outubro de 2019. Desde então, temos monitorado os logs de limite de taxa que foram gerados. Também passamos um tempo nos reunindo com muitos clientes e parceiros para discutir os dados de log. A seguir, um resumo de como nos adaptamos com base no que aprendemos.
Cabeçalhos de resposta da API
Para sites do Brightspace com a Limitação de taxa de API ativada, cada chamada de API do Brightspace agora inclui 3 dados adicionais em seu cabeçalho de resposta:
Limite de taxa X restante - o número restante de créditos disponíveis no minuto atual.
Nota: Esse valor só é significativo em sites do Brightspace que têm a Limitação de taxa de API ativada
Redefinição do limite da taxa X - fornece ao desenvolvedor a quantidade de tempo, em segundos, até que o bucket seja redefinido.
Custo de solicitação X - informa o desenvolvedor sobre o número de créditos que o custo atual da rota da API.
Para algumas soluções, esses valores de cabeçalho podem fornecer uma maneira de evitar que o limite de taxa exceda o limite de taxa.
Limitação de taxa de giro ativada para sites que não são de produção - 9 de março de 2020
Para fornecer a todos acesso a um ambiente Brightspace com a Limitação de taxa ativada, planejamos fazê-lo em todos os Não Produção Sites do Brightspace em 9 de março de 2020. Isso fornecerá a todos os clientes e parceiros acesso a um site onde eles podem:
- Crie um cenário de teste em que eles possam realmente exceder um limite de taxa e gerar um erro 429.
- Teste e use o Limite de taxa X restante (já que esse valor só é significativo em sites em que a Limitação de taxa de API está ativada).
IMPORTANTE - Se você NÃO quiser que a Limitação de taxa seja ativada para um de seus sites Brightspace que não sejam de produção, entre em contato com o TAM e/ou CSM da D2L antes de 9 de março.
Ativar o registro incremental - 2 de março de 2020
Alguns comentários que recebemos repetidamente são que você deseja saber se e quando seu aplicativo de API está se "aproximando" do valor limite de limitação de taxa. Para acomodar essa solicitação, adicionamos um novo recurso de "registro incremental" à nossa solução de limitação de taxa. Nosso plano é ativar o Log Incremental em 2 de março de 2020.
O Incremental Logging gerará Logs de Limite de Taxa quando qualquer Aplicativo de API usar mais de 30.000 créditos em um minuto. Logs adicionais serão gerados quando esse aplicativo de API exceder qualquer múltiplo de 10.000 em relação ao nível de crédito inicial de 30.000.
Por exemplo, se um aplicativo de API usar 72.000 créditos de API em um minuto, nosso recurso de registro incremental gerará 5 logs exclusivos: o primeiro será quando o aplicativo exceder 30.000 créditos, o próximo será quando o aplicativo exceder 40.000 créditos, o 3º para 50.000 créditos, o 4º para 60.000 créditos e o último log para exceder 70.000 créditos.
O log incremental fornece dois pontos de dados importantes:
- Ele fornece a todos nós um meio de determinar quais aplicativos de API estão "chegando perto" do limite de 50.000 créditos/minuto.
- Para aplicativos que estão excedendo o limite de crédito de 50.000, o registro incremental nos informa o quanto acima do limite o aplicativo foi.
Limitação de taxa de giro ON - segunda-feira, 8 de junho de 2020
Antes da publicação deste artigo, comunicamos que estávamos ativando a limitação de taxa em maio de 2020. Com base nos seus comentários, decidimos mudar a data de ativação para segunda-feira, 8 de junho de 2020 (para todos os sites de produção). O feedback geral foi que maio costuma ser um mês movimentado para a recuperação de dados do Brightspace por meio da API.
Conforme declarado anteriormente, se você tiver dúvidas sobre a ativação da limitação de taxa da API, informe seu TAM e/ou CSM da D2L. Inclua o aplicativo de API com o qual você está preocupado, além do motivo pelo qual você não deseja que a limitação de taxa seja ativada em junho.