Reddit App API
FR

Reddit App API · 01 / 08

Ajouter une étape de lecture à la préparation du voyage

Suivez un exemple de lecture sur offline maps : choisir la question, limiter la requête et distinguer les discussions anciennes de la navigation.

Choisir une question que l’archive peut éclairer

Cet exemple de conception est hypothétique. Une personne a choisi un itinéraire et prépare son téléphone à une utilisation sans connexion fiable. Elle souhaite lire des discussions sur offline maps : quoi télécharger avant de partir, quelles hypothèses vérifier sur son appareil et quelles questions poser sur le logiciel choisi. L’archive fournit des discussions historiques, pas les cartes.

Placez la lecture près des notes de préparation, pas dans les indications de navigation pas à pas. Un résultat ne devient pas un état vérifié du sentier parce qu’il figure à côté d’un itinéraire. Gardez le téléchargement cartographique, l’autorisation de localisation, les fermetures actuelles et la sécurité dans les parties adaptées de l’application. Les anecdotes historiques trouvent ainsi une utilité sans recevoir une autorité qu’elles n’ont pas.

Envoyer une petite requête volontaire

Commencez par la recherche proposée offline maps et le subreddit hiking. Le client transmet ces choix à votre serveur, qui pourrait appeler /v1/search?q=offline%20maps&subreddit=hiking&limit=3&page=1 avec la clé enregistrée. C’est une conception de requête, pas la preuve que trois enregistrements existent. La clé reste sur le serveur et ne fait pas partie de la saisie du randonneur.

Une petite première page permet de concevoir une tâche de lecture avant un grand flux. q utilise la correspondance AND du titre et du texte, pas une instruction de recherche sémantique ou d’expression exacte. Si la personne modifie les termes, expliquez la nouvelle recherche et recommencez la pagination. N’élargissez pas silencieusement la requête en présentant les nouveaux résultats comme ceux de la question initiale.

Faire du résultat une référence, pas une recommandation

L’archive renvoie des enregistrements à plat. Une fiche peut montrer le texte disponible, la communauté d’origine, une date de création valide et un lien exploitable. Un commentaire peut manquer de titre ou de contexte utile. Signalez les champs indisponibles au lieu de les inventer. Le regroupement local d’identifiants de parents présents peut relier quelques éléments, sans établir une conversation complète.

L’archive renvoie les enregistrements dans l’ordre des documents, et non par date, pertinence ou score. Adaptez l’interface : parlez de références historiques plutôt que de meilleures réponses. Le lecteur peut comparer des expériences différentes et ouvrir la source lorsqu’elle existe. Ne transformez pas un extrait relatif à l’équipement d’autrui en instruction validée pour cet appareil ou ce voyage.

Concevoir l’issue peu utile avant l’issue utile

Une requête réussie peut ne renvoyer aucun enregistrement. Conservez la saisie et proposez une modification volontaire, par exemple un autre terme. L’état vide décrit cette réponse ; il ne prouve pas que personne n’a parlé du sujet. Chaque récupération réussie consomme un crédit, même sans résultat. L’opérateur doit comprendre ce coût avant d’activer des recherches automatiques.

Un échec est différent. Conservez la question et proposez un nouvel essai au besoin. Les problèmes de clé et de crédits concernent l’opérateur ; le randonneur a besoin d’une explication brève indiquant que la recherche est indisponible. N’insérez pas de contrôles de paiement dans ce parcours et ne prenez pas un délai pour la preuve d’une panne de l’archive.

Laisser le lecteur repartir avec un résultat limité

Si pagination.has_more le permet, Afficher la suite peut récupérer une autre page avec les mêmes filtres et limit. Le lecteur peut préférer enregistrer une référence dans une liste locale de l’application. Aucune de ces actions ne garantit l’exhaustivité, la disponibilité permanente de la source ou une copie hors ligne de toute la conversation. Une référence sauvegardée ne télécharge pas non plus de carte utilisable.

Une conclusion utile serait une courte liste de questions à vérifier dans le logiciel cartographique et les conseils actuels réellement utilisés. C’est une intention de design, pas un bénéfice mesuré. Gardez le caractère historique visible lorsque les références réapparaissent. Retrouvez sur /fr/#field-notes les choix de fiches, de dates et de liste locale.