Les échecs de requêtes de l’API IndexNow dans Yandex Webmaster proviennent souvent d’erreurs de configuration, telles qu’un mauvais placement de clé, des codes d’état mal interprétés ou des définitions de portée restrictives. Lorsqu’un appel API renvoie un échec, le processus de diagnostic implique de vérifier la capacité du serveur à servir le fichier de vérification et de s’assurer que la charge utile JSON suit la structure requise. En isolant ces composants, vous pouvez restaurer la communication avec le moteur de recherche et maintenir un état d’indexation précis pour vos pages.
Pourquoi la vérification de ma clé IndexNow échoue-t-elle ?
Les échecs de vérification indiquent généralement que le moteur de recherche ne peut pas lire votre fichier de clé. Le fichier doit contenir uniquement la chaîne de la clé, sans caractères supplémentaires, balises HTML ou formatage. Si votre serveur renvoie une erreur 404 lors de l’accès au chemin du fichier de clé, la requête API échouera immédiatement, quelle que soit la charge utile. Nous recommandons de vérifier les en-têtes de réponse du serveur pour vous assurer que le fichier est servi avec un type de contenu text/plain.
De plus, l’encodage des caractères joue un rôle important dans la réussite de la vérification. Le fichier doit être enregistré en encodage UTF-8. Si votre serveur ajoute une marque d’ordre d’octets (BOM) ou des caractères d’espacement cachés, la chaîne de la clé pourrait ne pas correspondre à la valeur attendue. Vérifiez toujours le fichier manuellement via un navigateur ou un outil de ligne de commande comme curl pour vous assurer que la sortie est exactement ce que vous attendez.
- Vérifiez que le fichier est encodé en UTF-8 et ne contient que la chaîne de la clé.
- Assurez-vous que le nom du fichier correspond exactement à la chaîne de la clé (par exemple, key-123.txt).
- Confirmez que le fichier est accessible publiquement à la keyLocation définie.
- Vérifiez que la longueur de la clé est comprise entre 8 et 128 caractères.
- Supprimez tout wrapper HTML ou bannière côté serveur de la sortie du fichier.
Comment interpréter les codes d’état HTTP de l’API ?
Les codes de réponse HTTP agissent comme la principale boucle de rétroaction pour vos requêtes API. Une réponse 202 Accepted n’est pas une erreur ; elle indique que la requête est valide et qu’elle attend actuellement la vérification de la clé. Si vous recevez ce code, attendez simplement et continuez à soumettre vos URL. Une réponse 200 OK confirme que la clé est vérifiée et que les URL sont acceptées dans la file d’attente de traitement.
Les erreurs telles que 400 ou 403 nécessitent une attention immédiate. Une erreur 400 pointe généralement vers un corps JSON mal formé ou un paramètre keyLocation invalide. Une erreur 403 indique souvent que la clé fournie n’a pas l’autorisation de soumettre des URL pour l’hôte ou le répertoire spécifique. En enregistrant ces réponses dans votre script personnalisé, vous pouvez détecter les problèmes avant qu’ils n’affectent les performances d’indexation de votre site.
Comment Alien Road applique cela
Chez Alien Road, nous préférons l’intégration directe de l’API pour éviter les limitations des plugins CMS en boîte noire. Nous construisons des hooks personnalisés dans le pipeline de publication du client qui déclenchent une seule requête POST uniquement lorsqu’une page est créée, mise à jour ou supprimée. Cela garantit que nous respectons les normes d’efficacité tout en évitant le risque de soumettre des URL inchangées, ce qui peut gaspiller des ressources.
Nous surveillons également les réponses de l’API via un système de journalisation centralisé. Si nous détectons une série d’erreurs 403, notre script alerte automatiquement notre équipe technique pour vérifier les autorisations du fichier de clé. Par exemple, dans un projet récent, nous avons découvert un problème de mise en cache où le serveur servait une version obsolète du fichier de clé, entraînant des résultats de vérification incohérents sur plusieurs sous-domaines.
Nous voyons souvent des équipes en difficulté parce qu’elles s’appuient sur des plugins automatisés qui ignorent les en-têtes de réponse HTTP. En construisant notre propre logique, nous nous assurons qu’une réponse 202 est traitée correctement, évitant ainsi des redémarrages de vérification inutiles.
Équipe SEO d’Alien Road
Plusieurs clés peuvent-elles exister sur un même domaine ?
Oui, Yandex prend en charge l’utilisation de plusieurs clés sur un seul domaine. Cette fonctionnalité est utile lorsque vous gérez différentes sections d’un site avec des systèmes distincts. Par exemple, un blog hébergé dans un sous-répertoire séparé pourrait utiliser une clé spécifique, tandis que la boutique principale en utilise une autre. Vous devez vous assurer que chaque requête API pointe explicitement vers la keyLocation correcte pour ce système.
Lorsque vous utilisez plusieurs clés, gardez-les à la racine du site pour éviter les conflits au niveau du répertoire. Si un système tente de soumettre des URL qui tombent en dehors de la portée autorisée par sa clé, la requête échouera avec une violation de portée. Nous suggérons de tenir un fichier de documentation simple dans le référentiel du projet pour suivre quelle clé est attribuée à quel système afin d’éviter les écrasements accidentels ou les mauvaises configurations.
Comment résoudre les violations de portée ?
Les violations de portée se produisent lorsque l’emplacement du répertoire de la clé est trop étroit pour les URL soumises. Si votre fichier de clé est placé dans un sous-dossier comme /catalog/, il n’autorisera pas les soumissions d’URL pour /blog/ ou la page d’accueil. Le moyen le plus fiable d’éviter cela est de placer le fichier de clé dans le répertoire racine, ce qui permet à la clé de couvrir toute la structure du site.
Si vous devez utiliser des portées restreintes pour des raisons de sécurité ou de délégation, assurez-vous que vos requêtes API respectent strictement ces chemins. Par exemple, si une équipe gère uniquement la section /news/, assurez-vous que son intégration API est configurée uniquement pour ce chemin. Toute tentative de s’écarter de cette limite déclenchera une erreur. L’examen périodique de vos journaux vous aidera à identifier si un système spécifique tente de soumettre des URL qui tombent en dehors de sa portée autorisée.
- Placez la clé de vérification dans le répertoire racine pour une couverture large.
- Assurez-vous que le paramètre keyLocation correspond au chemin réel du fichier.
- Vérifiez que les URL soumises correspondent au domaine couvert par la clé.
- Utilisez des clés séparées pour des sous-domaines complètement indépendants.
- Examinez les journaux pour les erreurs 403, qui sont courantes pour les problèmes de portée.
Les problèmes de portée sont un tueur de performance silencieux. Vérifiez toujours que l’emplacement de votre clé est suffisamment large pour couvrir toute votre structure d’URL pendant la phase de configuration initiale.
Équipe SEO d’Alien Road
Par où commencer cette semaine
Commencez par auditer votre configuration IndexNow actuelle cette semaine. Utilisez un script de ligne de commande simple pour effectuer une requête curl vers votre fichier de clé afin de vérifier qu’il renvoie un état 200 et le contenu correct. Si vous utilisez un plugin tiers, vérifiez ses journaux pour voir s’il soumet des pages inchangées, car c’est une raison courante d’épuisement des ressources et de limitation potentielle du taux d’API.
Si vos journaux montrent des erreurs persistantes, envisagez de remplacer le plugin par un script direct. Un script de base qui envoie une requête POST JSON est simple à maintenir et offre un contrôle total sur le processus. En éliminant les dépendances tierces, vous obtenez une vue claire de vos communications API et pouvez résoudre les problèmes futurs avec un effort minimal.