Définir ce que signifie Enregistrer
Dans cette application proposée, Enregistrer conserve sur l’appareil actuel une référence historique choisie pour la lire plus tard. C’est une fonction à développer, pas un endpoint du service. Reddit App API ne fournit ni favoris, ni synchronisation entre appareils, ni compte de liste sauvegardée. Expliquez cette différence avant que le randonneur ne dépende de la liste en voyage.
Lorsque quelqu’un sauvegarde une discussion, l’application devrait conserver une référence minimale plutôt que dupliquer tout son texte. Gardez, lorsqu’ils existent, l’identifiant, un lien validé et assez de contexte pour reconnaître le choix. Si vous conservez aussi un court extrait choisi par la personne, expliquez ce choix et prenez en compte le contenu et les droits de tiers.
Ne pas confondre trois dates
L’application doit distinguer la création originale de l’instant où la personne a enregistré l’élément. Elle peut aussi noter quand elle a récupéré le contenu. Un libellé comme Enregistré sur cet appareil décrit une action locale, pas la rédaction, la vérification ou la mise à jour de la discussion à cette date. Une date originale absente reste inconnue.
Ne prenez pas un titre ou extrait sauvegardé pour la preuve que la source actuelle dit toujours la même chose. Conservez le contexte sans ajouter de détails inventés. Un commentaire enregistré depuis un résultat partiel reste une référence à cet élément, pas un fil complet ni la garantie que toutes les réponses voisines seront accessibles plus tard.
Séparer lecture locale et nouvelle consultation
La liste peut afficher les métadonnées ou extraits déjà conservés sans appeler de nouveau le service. Rendez volontaire toute nouvelle consultation au lieu d’actualiser chaque élément à l’ouverture. Chaque récupération réussie coûte un crédit, y compris un appel explicite à /v1/item?id=RECORD_ID. La clé de l’archive reste sur votre serveur.
Une consultation peut retourner un tableau data vide avec succès lorsqu’aucun élément n’est renvoyé ; ne supposez pas que le service répond 404 ou 410 pour une référence absente. Ce résultat vide réussi est facturé. Un échec ou une réponse perdue ne prouve pas non plus la suppression. Distinguez les libellés Indisponible lors de cette consultation, Échec de la requête et Non vérifié à nouveau.
Proposer des commandes locales cohérentes
Prévoyez une action claire Retirer de cet appareil. Selon votre conception, elle doit retirer la référence et l’extrait associés du stockage local. Elle ne supprime pas une publication Reddit ou une donnée d’archive, ne ferme pas le compte du service et ne modifie pas ses paiements. Ne présentez pas une commande locale comme une demande de suppression plus large.
Si vous choisissez une limite de stockage ou une durée de conservation, expliquez et testez cette règle de l’application sans inventer de délai imposé par le service. Permettez de comprendre ce qui sera supprimé. Le nettoyage de l’appareil, les restrictions du navigateur ou l’effacement des données peuvent aussi supprimer les copies locales. Un enregistrement n’est pas une promesse d’accès permanent.
Préciser les limites de la lecture hors ligne
Une liste contenant seulement des références peut nécessiter une connexion pour ouvrir les sources. Un extrait peut être lu localement si votre application le met en œuvre et le conserve, mais cela ne rend pas une discussion entière ou une carte disponible hors ligne. Montrez le contenu réellement stocké avant le départ hors connexion. Ce guide ne prétend pas que cette fonction a été développée ou testée.
Séparez ce stockage de la session du compte du service et de la référence de dernière facture. Le widget peut conserver un id de facture et un id utilisateur par hôte ; ce n’est pas une liste de lecture et il ne doit jamais servir à stocker la clé API. Toute sauvegarde, exportation ou synchronisation serait une fonction supplémentaire à concevoir et expliquer. Retrouvez sur /fr/#field-notes les fiches et le budget.
