Decide qué significa Guardar en tu app
En esta app propuesta, Guardar significa conservar en el dispositivo actual una referencia histórica elegida para leerla después. Es una función que debes implementar en tu aplicación, no un endpoint del archivo. Reddit App API no proporciona marcadores, sincronización entre dispositivos ni una cuenta de listas guardadas. Explica la diferencia antes de que alguien dependa de la lista durante un viaje.
Cuando una persona guarda una conversación, la app debería conservar una referencia mínima en lugar de duplicar todo el texto. Si están disponibles, guarda el identificador del registro, un enlace de origen validado y contexto suficiente para reconocer la selección. Si también conservas un fragmento breve elegido por el usuario, explica esa decisión y considera el contenido y los derechos de terceros.
No conviertas tres fechas en una
La app debe distinguir la creación original del registro del momento en que el usuario lo guardó. También puede anotar cuándo obtuvo el material elegido. Una etiqueta como Guardado en este dispositivo describe una acción de la app; no significa que la conversación se escribiera, comprobara o actualizara entonces. Deja desconocida una fecha original no disponible.
No trates un título o fragmento guardado como prueba de que la fuente actual sigue diciendo lo mismo. Conserva el contexto de la selección sin añadir detalles inventados. Un comentario guardado desde un resultado parcial sigue siendo una referencia a ese registro, no un hilo completo ni una garantía de que todas las respuestas circundantes estarán disponibles después.
Distingue abrir contenido local de hacer una consulta
La lista local puede mostrar metadatos o fragmentos que ya contiene sin llamar otra vez al servicio. Haz que una consulta nueva sea deliberada en lugar de actualizar todos los elementos al abrir la lista. Cada recuperación correcta cuesta un crédito y consultar explícitamente /v1/item?id=RECORD_ID también es una solicitud. La clave del archivo sigue en tu backend.
Una consulta de elemento puede devolver un array data vacío en una respuesta correcta si no se devuelve el registro; no supongas que el servicio utiliza 404 o 410 para un registro guardado ausente. Ese vacío correcto se cobra. Una solicitud fallida o una respuesta perdida tampoco demuestra que se haya eliminado el elemento. Usa etiquetas diferentes para no disponible en esta consulta, solicitud fallida y no comprobado de nuevo.
Ofrece controles locales que cumplan su promesa
Incluye una acción clara Eliminar de este dispositivo para la lista propuesta. Según el diseño de tu app, debería borrar la referencia y el fragmento asociados que se guardaron localmente. No elimina una publicación de Reddit ni un registro del archivo, cierra la cuenta del servicio ni modifica sus registros de pago. No presentes un control local como una solicitud de borrado más amplia.
Si eliges un límite de almacenamiento o una regla de caducidad, explica y prueba esa regla de la app en lugar de inventar un plazo de conservación del servicio. Permite entender qué se descartará. La limpieza del dispositivo, las restricciones del navegador o borrar los datos de la app también pueden eliminar material local. No prometas acceso permanente solo porque se guardó un elemento.
Explica con precisión el uso sin conexión
Una lista que solo guarda referencias puede necesitar conexión para abrir las fuentes. Un fragmento conservado puede leerse localmente si tu aplicación lo implementa y mantiene, pero no vuelve disponible sin conexión una conversación completa ni un mapa. Muestra qué contenido está realmente almacenado antes de que la persona se quede sin conectividad. Esta guía no afirma que se haya construido o probado esa función.
Separa ese almacenamiento de la sesión de cuenta y la referencia de última factura del sitio del servicio. El widget puede guardar un id de factura y otro de usuario por host; no es una lista de lectura ni debe reutilizarse para almacenar la clave API. Cualquier copia de seguridad, exportación o sincronización entre dispositivos sería una función adicional que debes diseñar y explicar. Vuelve a /es/#field-notes para el modelo de registros y el presupuesto de solicitudes.
