Biblioteca de lectura
Distingue con pantallas diferentes el vacío y el fallo de transporte
Separa una búsqueda vacía correcta de los errores HTTP y las respuestas perdidas, conservando la pregunta y haciendo deliberados los reintentos.
Define las clases de respuesta
Una zona vacía no explica qué pasó. En el cuaderno propuesto de LocalLLaMA, distingue petición en curso, éxito con registros, éxito con data vacío, error HTTP e intento del que no llegó una respuesta utilizable. Son observaciones diferentes. En particular, el vacío correcto no prueba que el archivo carezca de debates pertinentes, y una respuesta perdida no revela si el servidor terminó. No escondas estas interpretaciones tras el atajo visual sin resultados.
Usa el estado HTTP y una estructura validada conjuntamente. Un 200 con data: [] es una recuperación vacía correcta. HTTP 400, 401, 402, 429 y 502 son errores, no variantes del éxito vacío. Una excepción de red puede no proporcionar estado HTTP. No deduzcas solo del error si se recorrieron todas las etapas del backend. Guarda los parámetros y un identificador de petición de tu aplicación para asociar cada respuesta tardía con la búsqueda correcta.
Redacta acciones para el estado vacío
Usa un mensaje prudente: No se devolvieron registros para esta petición. Muestra q=quantization y subreddit=LocalLLaMA con las restricciones activas de fecha o puntuación. Permite editar una condición y enviar de nuevo de forma intencionada. No sustituyas el vacío con debates populares inventados ni amplíes automáticamente conservando la etiqueta anterior. Quitar un filtro hace que el nuevo resultado pertenezca a otra petición, que debe iniciar page=1.
Explica una restricción sin fingir diagnosticar la ausencia. En quantization memory, los términos deben coincidir dentro de un campo title o text; repartirlos entre ambos no basta. Es una consideración, no la causa demostrada de este vacío. Conserva la distinción económica: una recuperación vacía correcta cuesta un crédito. Una página profunda vacía puede tener total desconocido. No lo conviertas en cero coincidencias en todo el archivo ni en motivo para pedir páginas indefinidamente.
Redacta acciones para los fallos
Dirige el fallo a quien pueda resolverlo. HTTP 400 requiere examinar la entrada real, como un parámetro no admitido o una fecha distinta de YYYY-MM-DD. HTTP 401 trata de la clave de servicio; 402, de los créditos disponibles en su cuenta. Ninguno establece que haya caducado el acceso personal del lector. El operador quizá deba corregir la credencial del backend o revisar el saldo. No pidas al lector pegar una clave de servicio en el buscador público.
Para 429 respeta Retry-After y reduce los envíos repetidos. Para 502 conserva la consulta y ofrece un reintento consciente cuando proceda; el reembolso reservado puede esperar conciliación. Sin respuesta, el mensaje debe reconocer que el resultado, incluido el cobro, es desconocido. Los rechazos previos a la reserva no se cobran, pero una desconexión no demuestra ese rechazo. /v1/status es gratuito y muestra una declaración estática y respuesta HTTP; no resuelve la petición perdida ni verifica la salud de la búsqueda.
Prueba la continuidad de navegación
La continuidad también exige conservar la entrada del usuario. Planifica casos locales para un vacío válido, un error HTTP y una excepción de red antes de recibir respuesta. Usa material explícitamente sintético: probaría la interfaz, no la disponibilidad del archivo. Comprueba mensajes distintos y acceso a la consulta enviada. Añade el caso de editar el formulario mientras hay una petición pendiente: el resultado viejo no debe parecer respuesta a la expresión nueva.
Si falla la siguiente página, conserva los registros cargados y distingue su estado completado de la continuación fallida. Deja reintentar esa página o volver al formulario sin enviar otra petición oculta. Ignorar una respuesta tardía no garantiza cancelar el trabajo del servidor. Registra qué transiciones probó realmente tu aplicación y cuáles siguen propuestas. La meta es explicar lo conocido y ofrecer un paso útil, no tranquilizar con mensajes sin respaldo en la respuesta.
