Los fallos en las solicitudes de la API IndexNow en Yandex Webmaster suelen deberse a errores de configuración, como una colocación incorrecta de la clave, códigos de estado mal interpretados o definiciones de alcance restrictivas. Cuando una llamada a la API devuelve un error, el proceso de diagnóstico implica comprobar la capacidad del servidor para servir el archivo de verificación y asegurarse de que la carga útil JSON siga la estructura requerida. Al aislar estos componentes, puede restaurar la comunicación con el motor de búsqueda y mantener un estado de indexación preciso para sus páginas.
¿Por qué falla la verificación de mi clave de IndexNow?
Los fallos de verificación suelen indicar que el motor de búsqueda no puede leer su archivo de clave. El archivo debe contener solo la cadena de la clave, sin caracteres adicionales, etiquetas HTML ni formato. Si su servidor devuelve un error 404 al acceder a la ruta del archivo de clave, la solicitud de la API fallará inmediatamente independientemente de la carga útil. Recomendamos comprobar los encabezados de respuesta del servidor para asegurarse de que el archivo se sirva con un tipo de contenido text/plain.
Además, la codificación de caracteres juega un papel importante en una verificación exitosa. El archivo debe guardarse en codificación UTF-8. Si su servidor añade una marca de orden de bytes (BOM) o caracteres de espacio en blanco ocultos, es posible que la cadena de la clave no coincida con el valor esperado. Compruebe siempre el archivo manualmente a través de un navegador o una herramienta de línea de comandos como curl para asegurarse de que la salida sea exactamente lo que espera.
- Verifique que el archivo esté codificado en UTF-8 y contenga solo la cadena de la clave.
- Asegúrese de que el nombre del archivo coincida exactamente con la cadena de la clave (p. ej., key-123.txt).
- Confirme que el archivo sea accesible públicamente en la keyLocation definida.
- Compruebe que la longitud de la clave esté entre 8 y 128 caracteres.
- Elimine cualquier contenedor HTML o banner del lado del servidor de la salida del archivo.
¿Cómo interpretar los códigos de estado HTTP de la API?
Los códigos de respuesta HTTP actúan como el principal bucle de retroalimentación para sus solicitudes de API. Una respuesta 202 Accepted no es un error; indica que la solicitud es válida y actualmente está esperando la verificación de la clave. Si recibe este código, simplemente espere y continúe enviando sus URL. Una respuesta 200 OK confirma que la clave está verificada y las URL se han aceptado en la cola de procesamiento.
Los errores como 400 o 403 requieren atención inmediata. Un error 400 suele apuntar a un cuerpo JSON mal formado o a un parámetro keyLocation no válido. Un error 403 a menudo indica que la clave proporcionada no tiene permiso para enviar URL para el host o directorio específico. Al registrar estas respuestas en su script personalizado, puede detectar problemas antes de que afecten al rendimiento de indexación de su sitio.
Cómo aplica esto Alien Road
En Alien Road, preferimos la integración directa de la API para evitar las limitaciones de los complementos CMS de caja negra. Construimos ganchos personalizados en la canalización de publicación del cliente que activan una única solicitud POST solo cuando se crea, actualiza o elimina una página. Esto garantiza que cumplamos con los estándares de eficiencia mientras evitamos el riesgo de enviar URL sin cambios, lo que puede desperdiciar recursos.
También supervisamos las respuestas de la API a través de un sistema de registro centralizado. Si detectamos una serie de errores 403, nuestro script alerta automáticamente a nuestro equipo técnico para que verifique los permisos del archivo de clave. Por ejemplo, en un proyecto reciente, descubrimos un problema de almacenamiento en caché donde el servidor servía una versión obsoleta del archivo de clave, lo que provocaba resultados de verificación inconsistentes en varios subdominios.
A menudo vemos que los equipos tienen dificultades porque dependen de complementos automatizados que ignoran los encabezados de respuesta HTTP. Al construir nuestra propia lógica, nos aseguramos de que una respuesta 202 se maneje correctamente, evitando reinicios de verificación innecesarios.
Equipo SEO de Alien Road
¿Pueden existir varias claves en un mismo dominio?
Sí, Yandex admite el uso de varias claves en un solo dominio. Esta función es útil cuando gestiona diferentes secciones de un sitio con sistemas separados. Por ejemplo, un blog alojado en un subdirectorio separado podría usar una clave específica, mientras que la tienda principal usa otra. Debe asegurarse de que cada solicitud de API apunte explícitamente a la keyLocation correcta para ese sistema.
Cuando utilice varias claves, manténgalas en la raíz del sitio para evitar conflictos a nivel de directorio. Si un sistema intenta enviar URL que quedan fuera del alcance permitido por su clave, la solicitud fallará con una infracción de alcance. Sugerimos mantener un archivo de documentación simple dentro del repositorio del proyecto para realizar un seguimiento de qué clave está asignada a qué sistema para evitar sobrescrituras accidentales o configuraciones incorrectas.
¿Cómo resolver las infracciones de alcance?
Las infracciones de alcance ocurren cuando la ubicación del directorio de la clave es demasiado estrecha para las URL que se envían. Si su archivo de clave se coloca dentro de una subcarpeta como /catalog/, no autorizará envíos de URL para /blog/ o la página de inicio. La forma más fiable de evitar esto es colocando el archivo de clave en el directorio raíz, lo que permite que la clave cubra toda la estructura del sitio.
Si debe usar alcances restringidos por seguridad o delegación, asegúrese de que sus solicitudes de API se adhieran estrictamente a esas rutas. Por ejemplo, si un equipo maneja solo la sección /news/, asegúrese de que su integración de API esté configurada solo para esa ruta. Cualquier intento de desviarse fuera de este límite activará un error. Revisar periódicamente sus registros le ayudará a identificar si un sistema específico está intentando enviar URL que quedan fuera de su alcance permitido.
- Coloque la clave de verificación en el directorio raíz para una cobertura amplia.
- Asegúrese de que el parámetro keyLocation coincida con la ruta real del archivo.
- Compruebe que las URL enviadas coincidan con el dominio cubierto por la clave.
- Utilice claves separadas para subdominios completamente independientes.
- Revise los registros en busca de errores 403, que son comunes en problemas de alcance.
Los problemas de alcance son un asesino silencioso del rendimiento. Verifique siempre que la ubicación de su clave sea lo suficientemente amplia como para cubrir toda su estructura de URL durante la fase de configuración inicial.
Equipo SEO de Alien Road
Por dónde empezar esta semana
Comience auditando su configuración actual de IndexNow esta semana. Utilice un script de línea de comandos simple para realizar una solicitud curl a su archivo de clave para verificar que devuelve un estado 200 y el contenido correcto. Si está utilizando un complemento de terceros, revise sus registros para ver si está enviando páginas sin cambios, ya que esta es una razón común para el agotamiento de recursos y la posible limitación de la tasa de API.
Si sus registros muestran errores persistentes, considere reemplazar el complemento con un script directo. Un script básico que envía una solicitud POST JSON es fácil de mantener y proporciona un control total sobre el proceso. Al eliminar las dependencias de terceros, obtiene una visión clara de sus comunicaciones de API y puede resolver problemas futuros con un esfuerzo mínimo.