Referencia de solicitudes de la API de IndexNow

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

Una URL — GET

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

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

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

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

Códigos de respuesta que vale la pena manejar

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

Limitación de velocidad

Yandex afirma que hay ningún límite en el número de solicitudes y que sus algoritmos evitan envíos excesivos, al tiempo que documentan 429. Leídos en conjunto: envíe a medida que ocurran cambios, agrupe donde pueda y trate el 429 como contrapresión que requiere un reintento con retroceso en lugar de como un fallo.

Notas de implementación

Distinga el 202 del 200 en los registros para que una clave nueva no se confunda con una rota; trate el 422 como un fallo permanente que requiere una solución en lugar de un reintento; y agrupe los cambios en un solo POST en lugar de lanzar un GET por página, que es lo que suele activar el 429 en un sistema de publicación ocupado.