Aplicar limite de taxa em REST APIs

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura

    • Aplique limite de taxa às REST APIs para evitar o uso excessivo ou abuso de itens do catálogo disponíveis publicamente.

    Antes de Iniciar

    Função necessária: admin, catalog_admin, web_service_admin

    Por Que e Quando Desempenhar Esta Tarefa

    O limite de taxa restringe a criação descontrolada de itens do catálogo disponíveis publicamente, reduzindo os riscos associados a agentes mal-intencionados e bots automatizados.

    Procedimento

    1. Navegar até Tudo > Serviços web do sistema > Regras de Limite de Taxa.
    2. Selecione Novo.
      mostrando o formulário de regras de limite de taxa
    3. Insira os seguintes valores de campo.
      Tabela 1. Campos do formulário Regra de limite de taxa da REST API
      Campo Descrição
      Recurso de API REST Valor derivado dos valores inseridos nos campos a seguir.
      Nome Nome exclusivo para a regra de limite de taxa.
      API REST

      API REST selecionada na lista de todas as REST APIs externas da instância.

      Selecione Catálogo de serviços.
      Versão

      Versão da REST API. Os valores listados dependem da REST API selecionada.

      Selecione o mais recente.
      Recurso

      Recurso para a versão. Os valores listados dependem da versão selecionada.

      Selecione os recursos necessários:

      Por exemplo,

      • Comprar item
      • Enviar um Produtor de registro
      • Validar Regex de variável (se o item consistir em uma variável que requer validação de Regex)
      • Guia de pedido de check-out
      • Valor de exibição de variável
      • Verificação solicitada para delegação no item
      Ativo Marque a caixa para indicar que a regra de limite de taxa está ativa.

      As regras de limite de taxa são ativadas por padrão assim que são criadas. Você pode desativar as regras de limite de taxa para interromper a aplicação de um limite de taxa ou para ativar regras de limite de taxa para retomar a aplicação de um limite de taxa.
      Limite de solicitação por hora Número máximo de solicitações permitidas por hora.
      Nota:
      Sempre que você atualiza o valor deste campo, o Now Platform redefine a contagem de solicitações para 0 e exclui todas as violações da hora atual.
      Aplicar a
      Usuários restritos por esta regra:
      • O usuário único aplica o limite de taxa a um usuário específico.
      • Usuários com função aplicam o limite de taxa a todos os usuários com uma função específica.
      • Todos os usuários aplicam o limite de taxa a todos os usuários.
      Selecione Usuários com função.
      Função

      Função à qual o limite de taxa se aplica.

      Selecione Usuário convidado.
      Nota:
      Aparece somente quando você seleciona Usuários com função no campo Aplicar a.
    4. Selecione Enviar.

    Resultado

    O limite de taxa é aplicado às APIs publicamente disponíveis.