Agora você pode configurar a Proteção contra bots da Kinsta e consultar análises detalhadas do tráfego de bots por meio da API da Kinsta.

Adicionamos 13 novos endpoints que permitem consultar e alterar os níveis de proteção, bloquear Crawlers de IA, gerenciar as configurações de automação do WordPress e criar regras de exceção personalizadas. Você também pode consultar análises que mostram como o tráfego é classificado, como as solicitações são tratadas e quais origens são responsáveis pela maior parte da atividade.

Essas adições permitem integrar a Proteção contra bots às suas ferramentas de gerenciamento de sites, sistemas de monitoramento e fluxos de trabalho automatizados.

Consulte e altere os níveis de Proteção contra bots

Dois novos endpoints permitem consultar e alterar o nível de Proteção contra bots de um ambiente WordPress.

O endpoint Get bot protection level retorna a configuração atual do ambiente:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/level \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

For example, the response below shows that the environment is configured to block automated traffic:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "level": "block-automations"
  }
}

Você pode utilizar o novo endpoint Set bot protection level para alternar entre quatro níveis de proteção disponíveis:

  • block-malicious-traffic bloqueia tráfego malicioso conhecido como parte da proteção padrão da Kinsta.
  • block-automations bloqueia tráfego automatizado e malicioso.
  • challenge-bots também apresenta desafios a prováveis bots e tráfego não classificado.
  • challenge-everyone aplica desafios a todo o tráfego não verificado, incluindo visitantes provavelmente humanos.

Por exemplo, se um site apresentar um aumento na extração automatizada de dados ou em solicitações automatizadas suspeitas, você poderá mudar para o nível Desafiar bots:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/level \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "level": "challenge-bots"
  }'

A API retorna uma resposta 202 com um ID de operação:

{
  "message": "Setting a bot protection level in progress. Use the operation_id to check the status.",
  "status": 202,
  "operation_id": "environment:set-bot-protection-level-54fb80af-576c-4fdc-ba4f-b596c83f15a1"
}

Você pode utilizar o operation_id retornado para acompanhar a solicitação até que a alteração seja concluída.

Níveis de proteção mais elevados podem afetar solicitações automatizadas legítimas e, no nível mais rigoroso, apresentar desafios aos visitantes. Verifique como o nível selecionado afeta o tráfego normal do seu site antes de aplicá-lo de forma mais ampla.

Bloqueie ou desbloqueie Crawlers de IA

A API também disponibiliza dois endpoints para gerenciar a configuração Bloquear Crawlers de IA. Você pode utilizar o endpoint Get AI crawler block status para verificar se o bloqueio está ativado:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/ai-crawlers \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

A resposta inclui o campo ai_crawlers_blocking, que indica se a configuração está enabled ou disabled.

Para alterar a configuração, envie uma solicitação PUT para o mesmo caminho:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/ai-crawlers \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "enabled"
  }'

Definir status como enabled bloqueia Crawlers de IA, incluindo crawlers verificados que coletam conteúdo de sites para treinamento de IA e finalidades relacionadas. Utilize disabled para desativar essa restrição específica.

A configuração Bloquear Crawlers de IA da Kinsta não bloqueia crawlers tradicionais de mecanismos de pesquisa, como Googlebot e Bingbot, crawlers de pesquisa com IA, como OAI-SearchBot, nem agentes de IA iniciados por usuários, como ChatGPT-User. No entanto, solicitações dessas origens ainda podem receber desafios em níveis de proteção mais rigorosos caso apresentem padrões de atividade excessiva.

Isso oferece um controle separado sobre a coleta automatizada de conteúdo para IA, sem alterar o nível geral de proteção do seu site.

Consulte a documentação da API Block or unblock AI crawlers para obter todos os detalhes das solicitações e respostas.

Controle as automações do WordPress

Algumas funcionalidades e integrações do WordPress dependem de solicitações automatizadas ao seu site. Isso pode incluir serviços externos que acessam a API REST do WordPress, plugins que trocam dados com serviços de terceiros ou plataformas de automação que enviam webhooks.

Dois novos endpoints permitem verificar e controlar se as automações comuns do WordPress são permitidas pela Proteção contra bots.

O endpoint Get WP automations allow status retorna a configuração atual:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "level": "block-automations"
  }
}

Em seguida, você pode utilizar o endpoint Allow or block WP automations para alterá-la. Por exemplo, a solicitação abaixo ativa a permissão para automações comuns do WordPress:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/wp-automations \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "enabled"
  }'

A solicitação retorna um ID de operação que você pode utilizar para acompanhar a alteração. Essa configuração utiliza uma lista de permissões gerenciada pela Kinsta, que inclui endpoints e serviços comuns do WordPress. Ela pode ajudar quando uma Proteção contra bots mais rigorosa interfere em uma integração externa ou em um processo automatizado do qual seu site depende.

As solicitações originadas no próprio contêiner do site ou na infraestrutura interna da Kinsta já são permitidas. Portanto, as tarefas internas normais do WordPress não são afetadas por essa configuração.

Adicione, consulte e remova exceções da Proteção contra bots

Às vezes, você precisa de regras mais específicas do que as oferecidas por um nível geral de proteção. Por exemplo, talvez queira permitir solicitações de um serviço de monitoramento confiável e continuar apresentando desafios a outros tipos de tráfego automatizado.

Três novos endpoints permitem gerenciar exceções da Proteção contra bots para ambientes WordPress individuais.

Você pode criar uma exceção utilizando o endpoint Add bot protection exception rule. Cada regra possui três campos obrigatórios:

  • type identifica o critério de correspondência: ip, path, user_agent ou country.
  • action determina o que acontece com o tráfego correspondente: skip, challenge ou block.
  • value contém o endereço IP, caminho, agente de usuário ou país utilizado para a correspondência.

Por exemplo, a solicitação abaixo adiciona uma exceção que permite que solicitações de um endereço IP confiável contornem as regras da Proteção contra bots:

curl --request POST \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "ip",
    "action": "skip",
    "value": "192.0.2.1"
  }'

A API retorna um ID de operação quando a solicitação é aceita. Para consultar as exceções configuradas, utilize o endpoint Get bot protection exception rules:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

The response lists the rules, including their IDs, matching values, and actions:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "exception_rules": [
      {
        "id": "ip:skip:192.0.2.1",
        "type": "ip",
        "action": "skip",
        "value": "192.0.2.1"
      }
    ],
    "has_custom_waf_rules": false
  }
}

Você pode utilizar o ID da regra com o novo endpoint Remove bot protection exception rule:

curl --request DELETE \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "exception_rule_id": "ip:skip:192.0.2.1"
  }'

As exceções se aplicam a ambientes individuais. Portanto, uma regra criada para um ambiente de teste não é aplicada automaticamente ao ambiente de produção.

A ação skip permite contornar as regras da Proteção contra bots, mas não se sobrepõe à segurança básica da plataforma Kinsta nem à Proteção contra vulnerabilidades.

Analise o tráfego de bots por meio da API

Além dos nove endpoints de gerenciamento da Proteção contra bots, adicionamos quatro endpoints à seção Análises.

Eles fornecem dados sobre as solicitações que chegam ao seu site, como a Kinsta classifica esse tráfego e o que acontece com essas solicitações depois que são avaliadas pela Proteção contra bots.

Veja como a Proteção contra bots trata o tráfego recebido

O novo endpoint Get bot traffic flow retorna o total de solicitações por classificação de tráfego e resultado da proteção.

Você pode utilizá-lo para verificar quantas solicitações foram classificadas como tráfego provavelmente humano, tráfego de prováveis bots, Crawlers de IA ou outros tipos de tráfego, além de quantas foram permitidas, receberam desafios ou foram bloqueadas.

Por exemplo, a solicitação abaixo consulta os dados dos últimos 30 dias:

curl --request GET \
  --url 'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/bot-protection/traffic-flow?company_id={company_id}&time_span=30_days' \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

A resposta contém três seções principais dentro de traffic_flow: traffic_types, results e flows. O objeto flows relaciona cada classificação de tráfego aos resultados da proteção.

Isso permite visualizar o que aconteceu com o tráfego, em vez de consultar apenas a quantidade total de solicitações bloqueadas.

Acompanhe o tráfego de bots e os resultados da proteção ao longo do tempo

Dois endpoints adicionais fornecem análises de séries temporais:

Ambos retornam dados por hora quando time_span está definido como 24_hours e dados diários para períodos mais longos.

Por exemplo, o endpoint de solicitações ao longo do tempo retorna dados neste formato:

{
  "analytics": {
    "requests_over_time": [
      {
        "traffic_type": "likely_humans",
        "label": "Likely humans",
        "total": 10572,
        "timeline": [
          {
            "date": "2026-09-14T00:00:00.000Z",
            "requests": 5286
          }
        ]
      }
    ]
  }
}

Esses dados podem ajudar a investigar aumentos incomuns de tráfego e verificar se as alterações nas configurações da Proteção contra bots afetam a quantidade de solicitações submetidas a desafios ou bloqueadas.

Identifique as principais origens do tráfego de bots

O novo endpoint Get bot traffic top breakdown fornece mais detalhes sobre as origens de cada classificação de tráfego. Ele retorna os caminhos mais solicitados, agentes de usuário, países e endereços IP, juntamente com suas respectivas quantidades de solicitações.

Por exemplo, se seu site apresentar um aumento repentino de solicitações automatizadas, você poderá verificar se essas solicitações estão concentradas em /wp-login.php, em um caminho específico da API ou em determinados endereços IP.

O endpoint retorna as informações em analytics.top_requests_breakdown, com arrays separados top_paths, top_user_agents, top_countries e top_ips para cada categoria de tráfego.

Todos os quatro novos endpoints de análise oferecem suporte a 24_hours, 7_days, 30_days e 60_days, com 7_days como padrão. Você também pode utilizar os parâmetros opcionais from e to para solicitar um intervalo de datas personalizado. Cada solicitação exige o parâmetro de consulta company_id.

Integre a Proteção contra bots aos seus fluxos de trabalho de gerenciamento de sites

Com esses endpoints, você pode incluir as configurações da Proteção contra bots junto de outras tarefas gerenciadas pela API da Kinsta.

Por exemplo, uma ferramenta de monitoramento pode consultar as análises de tráfego de bots durante um pico de tráfego, enquanto um sistema de gerenciamento interno pode verificar o nível atual de proteção de um ambiente e aplicar uma configuração diferente quando necessário. Você também pode gerenciar exceções para serviços confiáveis sem precisar configurar cada ambiente manualmente.

Encontre os formatos completos das solicitações e respostas na referência da API de Proteção contra bots do WordPress e na documentação de Análises da API da Kinsta.