Decidere cosa significhi Salva nella tua app
Nell’app escursionistica proposta, Salva significa conservare sul dispositivo corrente un riferimento storico scelto, da leggere più tardi. È una funzione da implementare nell’applicazione, non un endpoint dell’archivio. Reddit App API non fornisce segnalibri, sincronizzazione tra dispositivi o account per liste salvate. Spiega la distinzione prima che l’escursionista faccia affidamento sulla lista in viaggio.
Quando una persona salva una discussione, l’app dovrebbe conservare un riferimento minimo alla fonte invece di duplicare l’intero corpo del post. Se disponibili, mantieni identificatore del record, link convalidato e contesto sufficiente a riconoscere la scelta. Se conservi anche un breve estratto selezionato dall’utente, rendi esplicita la scelta e considera contenuto e diritti di terzi.
Non confondere tre date in una sola
L’app deve distinguere il momento originale di creazione del record da quello del salvataggio da parte dell’utente. Può registrare anche quando ha recuperato il materiale. Una dicitura come Salvato su questo dispositivo descrive un’azione dell’app, non implica che la discussione sia stata scritta, verificata o aggiornata quel giorno. Una data originale non disponibile deve restare sconosciuta.
Non trattare un titolo o estratto salvato come prova che la fonte attuale dica ancora la stessa cosa. Mantieni il contesto della selezione senza aggiungere dettagli inventati. Un commento salvato da un risultato parziale resta il riferimento a quel record, non un thread completo né una garanzia che tutte le risposte vicine saranno disponibili in futuro.
Separare l’apertura locale da una nuova consultazione
Una lista locale può mostrare metadati o estratti che già conserva senza richiamare il servizio. Rendi intenzionale una nuova consultazione invece di aggiornare silenziosamente tutti gli elementi a ogni apertura. Ogni recupero riuscito costa un credito; anche una ricerca esplicita /v1/item?id=RECORD_ID è una richiesta. La chiave dell’archivio resta nel backend.
Una consultazione può restituire un array data vuoto riuscito quando non viene trovato alcun record: non presumere che il servizio usi 404 o 410 per un riferimento salvato mancante. Quel successo vuoto è addebitato. Nemmeno una richiesta fallita o una risposta persa prova che l’elemento sia stato cancellato. Usa etichette distinte per Non disponibile in questa consultazione, Richiesta fallita e Non verificato di nuovo.
Offrire controlli locali coerenti con la promessa
Prevedi un’azione chiara Rimuovi da questo dispositivo per la lista proposta. Deve eliminare il riferimento locale e l’estratto associato secondo il progetto dell’app. Non cancella un post Reddit, né rimuove un record dall’archivio, né chiude l’account del servizio, né modifica i pagamenti. Non presentare un comando locale come una richiesta di cancellazione più ampia.
Se scegli un limite di spazio o una regola di scadenza, spiega e verifica quella regola dell’app invece di inventare un termine di conservazione del servizio. Consenti ai lettori di capire cosa verrà scartato. Pulizia del dispositivo, restrizioni del browser o cancellazione dei dati dell’app possono rimuovere il materiale locale. Non promettere accesso permanente solo perché l’elemento è stato salvato.
Esplicitare aspettative offline limitate
Una lista di soli riferimenti può richiedere una connessione per aprire la fonte. Un estratto conservato può essere leggibile localmente se l’app lo implementa e mantiene, ma ciò non rende disponibile offline tutta una discussione o una mappa. Mostra cosa è davvero memorizzato prima che la persona lasci la copertura. Questa guida non afferma che una simile funzione offline sia stata costruita o testata.
Tieni questo spazio dell’app separato dalla sessione dell’account sul sito e dal riferimento all’ultima fattura. Il widget può conservare id di fattura e utente per host: non è una lista di lettura e non va mai riutilizzato per memorizzare la chiave API. Backup, esportazione o sincronizzazione tra dispositivi sarebbero funzioni aggiuntive da progettare e dichiarare. Torna a /it/#field-notes per adattamento dei record e budget delle richieste.
