Donnez une tâche précise au premier écran
Un aperçu peut commencer par une question simple : quels fragments disponibles votre application peut-elle afficher ? Reddit Fetch permet aux développeurs JavaScript de consulter une archive historique indépendante de Reddit. Choisissez une communauté et prévoyez un libellé pour le texte absent avant de lancer la requête. Chaque décision sur les données répondra ainsi à un besoin concret de votre écran.
L’exemple utilise GET https://api.redditfetch.com/v1/comments?subreddit=javascript&limit=3. Le paramètre subreddit=javascript sélectionne la communauté ; limit=3 demande au plus trois commentaires. Cette limite ne promet pas trois cartes remplies. La réponse peut contenir moins d’enregistrements, voire aucun. Les fragments ne proviennent pas nécessairement de la même discussion : leur proximité dans la liste ne suffit pas à les relier.
Gardez l’appel dans votre processus serveur
Exécutez fetch dans votre service Node.js et chargez REDDIT_FETCH_API_KEY depuis une configuration privée. Vérifiez sa présence avant l’appel. Les deux en-têtes Authorization: Bearer <key> et X-API-Key: <key> sont acceptés. Le marqueur représente votre secret enregistré ; il ne s’agit pas d’une clé à publier dans le JavaScript que téléchargent les navigateurs de vos visiteurs.
Conservez une destination fixe pour ce premier essai. Après vérification, votre serveur peut transmettre au navigateur une représentation limitée aux besoins de l’aperçu. Ne transmettez pas le secret et ne remplacez pas la destination par une URL arbitraire fournie par un visiteur. Définissez aussi qui peut actualiser l’écran : cacher la clé ne limite pas, à lui seul, la consommation de votre route.
Affichez le sens du résultat obtenu
Une promesse fetch résolue ne prouve pas la réussite HTTP. Examinez response.ok avant d’interpréter le corps comme des commentaires, puis décodez le JSON et vérifiez les champs utiles. Une exception réseau constitue un autre résultat ; le décodage peut également échouer après réception. Ces étapes appellent des traitements distincts, sans tout réduire à une liste vide.
Les commentaires sont des fragments plats. Examinez le texte disponible, choisissez un libellé local pour une valeur absente et affichez le contenu comme du texte. Chargement, aperçu prêt, résultat vide et échec sont des états définis par votre application. Un échantillon vide de l’archive ne prouve pas que la communauté ne contient aucun commentaire, et trois fragments ne forment pas une conversation complète.
Choisissez quand une actualisation est utile
Chaque récupération réussie coûte un crédit, même vide. Le tarif est de $1 pour 1000 requêtes réussies ; le minimum de $50 achète 50000 crédits payants. Les crédits d’essai dépendent de l’éligibilité. Une copie locale peut être réutilisée sans nouvelle récupération, mais une actualisation réussie consomme un autre crédit, même si le texte visible reste identique.
L’archive est indépendante, sans affiliation officielle à Reddit ni flux en direct. La couverture complète, la disponibilité permanente et l’immuabilité des réponses ne sont pas garanties. Présentez l’aperçu comme historique et ne confondez pas l’ordre de l’archive avec celui des dates. La page de clé prépare le serveur, le guide traite les échecs et la documentation précise le format de réponse.