Vous pouvez désormais configurer la protection contre les robots de Kinsta et obtenir des analyses détaillées du trafic généré par les robots via l’API Kinsta.

Nous avons ajouté 13 nouveaux points de terminaison qui vous permettent de vérifier et de modifier les niveaux de protection, de bloquer les robots d’indexation basés sur l’IA, de gérer les réglages d’automatisation de WordPress et de créer des règles d’exception personnalisées. Vous pouvez également obtenir des analyses indiquant comment le trafic est classé, comment les requêtes sont traitées et quelles sources génèrent le plus d’activité.

Ces ajouts vous permettent d’intégrer la protection contre les robots à vos outils de gestion de site, à vos systèmes de surveillance et à vos flux de travail automatisés.

Vérifier et modifier les niveaux de protection contre les robots

Deux nouveaux points de terminaison vous permettent de récupérer et de modifier le niveau de protection contre les robots pour un environnement WordPress.

Le point de terminaison « Get bot protection level » renvoie la configuration actuelle de l’environnement :

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

Par exemple, la réponse ci-dessous indique que l’environnement est configuré pour bloquer le trafic automatisé :

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

Vous pouvez utiliser le nouveau point de terminaison « Set bot protection level » pour basculer entre les quatre niveaux pris en charge :

  • « block-malicious-traffic » bloque le trafic malveillant connu dans le cadre de la protection de base de Kinsta.
  • « block-automations » bloque le trafic automatisé et malveillant.
  • « challenge-bots » soumet également à des tests de vérification les robots potentiels et le trafic non classifié.
  • « challenge-everyone » applique des vérifications à l’ensemble du trafic non vérifié, y compris aux visiteurs potentiellement humains.

Par exemple, si un site subit une augmentation des activités de scraping ou des requêtes automatisées suspectes, vous pouvez passer au niveau « Défier les robots » :

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

L’API renvoie une réponse 202 avec un identifiant d’opération :

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

Vous pouvez utiliser l’operation_id renvoyé pour suivre la requête jusqu’à ce que la modification soit effective.

Des niveaux de protection plus élevés peuvent affecter les requêtes automatisées légitimes et, au niveau le plus strict, poser des difficultés aux visiteurs. Vérifiez l’impact du niveau sélectionné sur le trafic normal de votre site avant de l’appliquer à plus grande échelle.

Bloquer ou débloquer les robots d’indexation IA

L’API fournit également deux points de terminaison permettant de gérer le réglage « Bloquer les robots d’indexation IA ». Vous pouvez utiliser le point de terminaison « Obtenir l’état de blocage des robots d’indexation IA » pour vérifier si le blocage est activé :

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

La réponse comprend le champ « ai_crawlers_blocking », qui indique si le réglage est « enabled » ou « disabled ».

Pour modifier ce réglage, envoyez une requête PUT vers le même chemin d’accès :

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

En définissant le « status » sur « enabled », vous bloquez les robots d’indexation IA, y compris les robots vérifiés qui collectent le contenu de sites web à des fins d’entrainement de l’IA et à d’autres fins connexes. Utilisez « disabled » pour désactiver cette restriction spécifique.

Le réglage « Bloquer les robots d’indexation IA » de Kinsta ne bloque pas les robots d’indexation traditionnels des moteurs de recherche tels que Googlebot et Bingbot, les robots d’indexation IA tels que OAI-SearchBot, ni les agents IA lancés par les utilisateurs tels que ChatGPT-User. Toutefois, les requêtes provenant de ces sources peuvent tout de même être remises en cause dans le cadre de niveaux de protection plus stricts si elles présentent un comportement excessif.

Cela vous offre un contrôle distinct sur la collecte automatisée de contenu par l’IA sans modifier le niveau de protection global de votre site.

Consultez la documentation API « Bloquer ou débloquer les robots d’indexation IA » pour obtenir tous les détails relatifs aux requêtes et aux réponses.

Contrôler les automatisations WordPress

Certaines fonctionnalités et intégrations de WordPress s’appuient sur des requêtes automatisées adressées à votre site. Il peut s’agir de services externes accédant à l’API REST de WordPress, d’extensions échangeant des données avec des services tiers ou de plateformes d’automatisation envoyant des webhooks.

Deux nouveaux points de terminaison vous permettent de vérifier et de contrôler si les automatisations WordPress courantes sont autorisées par la protection contre les robots.

Le point de terminaison « Get WP automations allow status » renvoie le réglage actuel :

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "wp_automations": "enabled"
  }
}

Vous pouvez ensuite utiliser le point de terminaison « Allow or block WP automations » pour le modifier. Par exemple, la requête suivante autorise les automatisations WordPress courantes :

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

La requête renvoie un identifiant d’opération que vous pouvez utiliser pour suivre la modification. Ce réglage utilise une liste d’autorisations gérée par Kinsta, regroupant les points de terminaison et services WordPress courants. Il peut s’avérer utile lorsque des mesures de protection contre les robots plus strictes interfèrent avec une intégration externe ou un processus automatisé dont dépend votre site.

Les requêtes provenant du conteneur propre au site ou de l’infrastructure interne gérée par Kinsta sont déjà autorisées ; les tâches WordPress internes normales ne sont donc pas affectées par ce paramètre.

Ajouter, consulter et supprimer des exceptions à la protection contre les robots

Vous avez parfois besoin de règles plus spécifiques que celles offertes par un niveau de protection général. Par exemple, vous pouvez souhaiter autoriser les requêtes provenant d’un service de surveillance de confiance tout en continuant à filtrer le reste du trafic automatisé.

Trois nouveaux points de terminaison vous permettent de gérer les exceptions à la protection contre les robots pour chaque environnement WordPress.

Vous pouvez créer une exception à l’aide du point de terminaison « Ajouter une règle d’exception à la protection contre les robots ». Chaque règle comporte trois champs obligatoires :

  • le type identifie ce qu’il faut faire correspondre : ip, path, user_agent ou country.
  • action détermine le traitement du trafic correspondant : skip, challenge ou block.
  • « value » contient l’adresse IP, le chemin d’accès, l’agent utilisateur ou le pays à faire correspondre.

Par exemple, la requête suivante ajoute une exception qui autorise les requêtes provenant d’une adresse IP de confiance à contourner les règles de protection contre les robots :

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

L’API renvoie un identifiant d’opération lorsqu’elle accepte la requête. Pour consulter les exceptions configurées, utilisez le point de terminaison « Récupérer les règles d’exception de protection contre les robots » :

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

La réponse répertorie les règles, y compris leurs identifiants, les valeurs correspondantes et les 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
  }
}

Vous pouvez utiliser l’identifiant de la règle avec le nouveau point de terminaison « Supprimer une règle d’exception de la protection anti-robot » :

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

Les exceptions s’appliquent à des environnements individuels ; ainsi, une règle créée pour un environnement de staging ne s’applique pas automatiquement à l’environnement de production.

L’action « skip » contourne les règles de protection contre les robots, mais elle ne remplace pas la sécurité de la plateforme sous-jacente de Kinsta ni la protection contre les vulnérabilités.

Analysez le trafic des robots via l’API

Outre les neuf points de terminaison de gestion de la protection contre les bots, nous avons ajouté quatre points de terminaison à la section « Analyses ».

Ceux-ci fournissent des données sur les requêtes qui parviennent à votre site, sur la manière dont Kinsta classe ce trafic et sur ce qu’il advient de ces requêtes une fois qu’elles ont été évaluées par la protection contre les robots.

Découvrez comment la protection contre les robots gère le trafic entrant

Le nouveau point de terminaison « Get bot traffic flow » renvoie le nombre total de requêtes par classification de trafic et par résultat de protection.

Vous pouvez l’utiliser pour voir combien de requêtes ont été classées comme provenant probablement d’utilisateurs humains, de robots, de robots d’indexation IA ou d’autres types de trafic, et combien ont été autorisées, soumises à une vérification ou bloquées.

Par exemple, la requête suivante récupère les données des 30 derniers jours :

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>'

La réponse contient trois sections principales au sein de « traffic_flow » : « traffic_types », « results » et « flows ». L’objet « flows » relie chaque classification de trafic à ses résultats de protection.

Cela vous permet de voir ce qu’il est advenu du trafic au lieu de vous limiter à un simple décompte global des requêtes bloquées.

Suivez le trafic des robots et les résultats de protection au fil du temps

Deux points de terminaison supplémentaires fournissent des analyses chronologiques :

Ces deux points de terminaison renvoient des données horaires lorsque time_span est défini sur 24_hours, et des données quotidiennes pour les périodes plus longues.

Par exemple, le point de terminaison « requests-over-time » renvoie des données sous ce format :

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

Ces données peuvent vous aider à analyser les augmentations inhabituelles du trafic et à déterminer si les modifications apportées aux paramètres de protection contre les robots ont une incidence sur le nombre de requêtes remises en question ou bloquées.

Identifier les principales sources de trafic de robots

Le nouveau point de terminaison « Get bot traffic top breakdown » fournit davantage de détails sur les sources à l’origine de chaque classification de trafic. Il renvoie les chemins d’accès, les agents utilisateurs, les pays et les adresses IP les plus sollicités, ainsi que le nombre de requêtes correspondantes.

Par exemple, si votre site enregistre une augmentation soudaine des requêtes automatisées, vous pouvez vérifier si ces requêtes se concentrent sur /wp-login.php, un chemin d’API particulier ou proviennent d’adresses IP spécifiques.

Le point de terminaison renvoie les informations sous « analytics.top_requests_breakdown », avec des tableaux distincts « top_paths », « top_user_agents », « top_countries » et « top_ips » pour chaque catégorie de trafic.

Les quatre nouveaux points de terminaison d’analyse prennent en charge les périodes « 24_hours », « 7_days », « 30_days » et « 60_days », la valeur par défaut étant « 7_days ». Vous pouvez également utiliser les paramètres facultatifs « from » et « to » pour demander une plage de dates personnalisée. Chaque requête nécessite un paramètre de requête « company_id ».

Intégrez la protection contre les robots à vos workflows de gestion de site

Grâce à ces points de terminaison, vous pouvez intégrer les réglages de protection contre les robots aux autres tâches gérées via l’API Kinsta.

Par exemple, un outil de surveillance peut récupérer les analyses du trafic généré par les robots lors d’un pic de trafic, tandis qu’un système de gestion interne peut vérifier le niveau de protection actuel d’un environnement et appliquer un réglage différent si nécessaire. Vous pouvez également gérer des exceptions pour les services de confiance sans avoir à configurer manuellement chaque environnement.

Vous trouverez les formats complets des requêtes et des réponses dans la référence de l’API de protection contre les robots de WordPress et dans la documentation relative aux analyses de l’API Kinsta.