Referencia de solicitud de la API de IndexNow

La API es deliberadamente pequeña: un endpoint, dos métodos.

Una URL — GET

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

url y key son obligatorios; keyLocation solo es necesario cuando el archivo de clave no está en la raíz. La URL debe cumplir con RFC 3986.

Muchas URLs — 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", … ] }

Hasta 10,000 URLs por solicitud. host, key y urlList son obligatorios.

Códigos de respuesta a gestionar

• 200 OK — aceptado.
• 202 Accepted — nueva clave pendiente de verificación. No es un error; continúe enviando.
• 400 — parámetros no válidos en el cuerpo.
• 403 Invalid key — la clave no pudo cargarse o no coincide con las URLs enviadas. En una clave con alcance de directorio, esto suele ser una violación de alcance en lugar de una clave incorrecta.
• 405 — solo se admiten GET y POST.
• 422 — la familia extensa: ubicación de clave no válida, URL no válida, clave demasiado corta o larga, caracteres no válidos, falta de clave, host o URL, más de 10,000 URLs, urlList no es una matriz o está vacío.
• 429 Too Many Requests — se superó el límite por IP.

Limitación de tasa

Yandex afirma que no hay límite en el número de solicitudes y que sus algoritmos previenen el envío excesivo, aunque también documentan el 429. Interpretado en conjunto: envíe a medida que ocurran los cambios, agrupe cuando pueda y trate el 429 como una contrapresión que requiere un reintento con retroceso exponencial en lugar de un fallo.

Notas de implementación

Distinga el 202 del 200 en los registros para no confundir una clave nueva con una rota; trate el 422 como un fallo permanente que requiere una corrección en lugar de un reintento; y agrupe los cambios en un único POST en lugar de disparar un GET por página, que es lo que suele activar el 429 en un sistema de publicación con mucho tráfico.