Référence des requêtes de l'API IndexNow

L’API est volontairement simple : un point de terminaison, deux méthodes.

Une URL — GET

GET https://yandex.com/indexnow?url=<String>&key=<String>[&keyLocation=<String>]

url et key sont requis ; keyLocation uniquement lorsque le fichier de clé n’est pas à la racine. L’URL doit être conforme à la norme RFC 3986.

Plusieurs URL — POST

POST https://yandex.com/indexnow
Content-Type: application/json; charset=utf-8

{ "host": "www.example.com",
  "key": "…",
  "keyLocation": "https://www.example.com/key.txt",
  "urlList": [ "https://www.example.com/url1", … ] }

Jusqu’à 10 000 URL par requête. host, key et urlList sont requis.

Codes de réponse à prendre en compte

• 200 OK — accepté.
• 202 Accepted — nouvelle clé en attente de vérification. Ce n’est pas une erreur ; continuez à soumettre.
• 400 — paramètres invalides dans le corps.
• 403 Clé invalide — la clé n’a pas pu être chargée ou ne correspond pas aux URL soumises. Pour une clé limitée à un répertoire, il s’agit généralement d’une violation de portée plutôt que d’une mauvaise clé.
• 405 — seuls GET et POST sont pris en charge.
• 422 — la grande famille : emplacement de clé invalide, URL invalide, clé trop courte ou trop longue, caractères invalides, clé, hôte ou URL manquants, plus de 10 000 URL, urlList n’est pas un tableau ou est vide.
• 429 Too Many Requests — la limite par IP a été dépassée.

Limitation du taux

Yandex indique qu’il n’y a aucune limite sur le nombre de requêtes et que ses algorithmes empêchent les soumissions excessives — tout en documentant 429. En résumé : soumettez au fur et à mesure des modifications, regroupez lorsque c’est possible, et considérez le code 429 comme une contre-pression nécessitant une nouvelle tentative avec recul plutôt que comme un échec.

Notes d’implémentation

Distinguez le code 202 du code 200 dans les journaux afin qu’une nouvelle clé ne soit pas confondue avec une clé défectueuse ; traitez le code 422 comme un défaut permanent nécessitant une correction plutôt qu’une nouvelle tentative ; et regroupez les modifications dans un seul POST plutôt que de déclencher un GET par page, ce qui déclenche généralement une erreur 429 sur un système de publication actif.