Separa usuario, trabajo y cuenta de pago
El usuario del producto, el trabajo interno y la cuenta del dominio que paga las lecturas son tres identidades distintas. Tu backend vincula las dos primeras y comprueba su autorización. El navegador recibe el resultado permitido. Si recibe la clave compartida, su poseedor podría iniciar consultas de pago fuera de los límites de la pantalla.
No publiques la clave en código del navegador, repositorios, archivos descargables o registros. Puedes cargarla mediante una variable de entorno del servidor o un gestor de secretos. Eso separa configuración y código, pero no evita por sí solo que una herramienta de depuración o una excepción la revele. Revisa también cabeceras, respuestas de error y copias de configuración que salgan de tu infraestructura.
Construye una solicitud permitida
Fija el host del archivo y la ruta admitida para el primer trabajo. Construye q=onboarding, subreddit=SaaS y limit=3 con valores validados, y añade la clave justo al enviar la solicitud. No adjuntes la credencial a una URL arbitraria del visitante. El permiso para ejecutar el trabajo debe resolverse antes de este paso.
Para investigar el gasto de la búsqueda de onboarding, tu registro local necesita el identificador del trabajo, sus filtros y el número de intento, no la cabecera que contiene el secreto. El cliente HTTP puede enviar X-API-Key: <clave> o Authorization: Bearer <clave>, tomando la clave de una configuración protegida del servidor. Exclúyela del código público, las respuestas al navegador y los diagnósticos. La cookie Secure HttpOnly administra la sesión de la cuenta; los identificadores de usuario y factura que el widget conserva en localStorage por hostname tampoco son credenciales de recuperación. Revisa esos recorridos de datos al integrar el registro de costes, sin suponer que esta separación elimina todos los riesgos de exposición.
Anota los intentos antes de repetir
Asigna un identificador interno y un pequeño presupuesto de intentos. Registra ruta, filtros, número de intento y resultado sin cabeceras de autenticación. Una política de ejemplo permite tres intentos en total, incluidos cambios de página y repeticiones. Es una regla propia del producto, no una cuota por usuario ni un registro de trabajos proporcionado por el archivo.
Considera una secuencia incómoda: un primer éxito vacío cuesta un crédito; la segunda respuesta se pierde y puede haber costado otro; una repetición exitosa añade un crédito más. No clasifiques la pérdida de respuesta como fallo gratuito. Los fallos del sistema de origen devuelven la reserva, pero un error local de análisis o almacenamiento no deshace un éxito cobrado.
Guarda la respuesta antes de interpretarla
Guarda la respuesta antes de adaptarla a la pantalla. Los registros son planos; pueden faltar campos y los parent_id o link_id pueden señalar material no recibido. Agruparlos no demuestra conversaciones completas. Las fechas usan YYYY-MM-DD en UTC, con to incluido. q busca en title y text, aplicando AND dentro del campo coincidente; min_score filtra, y _doc no es un orden temporal ni una clasificación.
Cambia la clave sin contar con un solapamiento
Prepara la sustitución deteniendo la admisión de nuevos trabajos. Tras iniciar sesión y confirmar la contraseña, regenerar invalida de inmediato la clave anterior. Actualiza los procesos que hacen consultas antes de reanudarlos. No dependas de un solapamiento entre credenciales. Limita también quién puede leer el nuevo valor durante su entrega y evita copiarlo a los diagnósticos.
Un límite local solo controla las llamadas que pasan por tu backend. No frena el uso directo de una clave filtrada. Compara tus intentos con el contexto de la cuenta al investigar, sin tratar un aumento de volumen como prueba de filtración. Cambiar la clave no recupera créditos gastados. Conserva la contraseña: no hay restablecimiento ni envío de clave por correo.
Comprueba el recorrido con un trabajo pequeño
Ejecuta finalmente un trabajo pequeño y revisa su desenlace real. Ante 400 comprueba parámetros; ante 401, credencial; ante 402, saldo; ante 429, frecuencia. Hay hasta 100 registros por solicitud y 100 páginas por consulta, sin cobertura completa garantizada. /v1/status ofrece información estática de alcance, no comprueba la salud del archivo. Guardar una muestra y decidir detenerse también puede cerrar correctamente el trabajo.
