Définissez le résultat d'une exécution
Ici, terminer signifie traiter un lot limité d'exemples de r/automation et enregistrer son résultat. Cela ne signifie pas avoir parcouru toute l'archive. Faites d'abord un essai manuel, puis choisissez une fréquence compatible avec le temps consacré à la lecture de la file.
Créez un identifiant local d'exécution, conservez les paramètres et définissez la destination des fiches retenues. Ce sont des informations de votre application, pas de nouveaux paramètres de l'API. Si un exemple attendu manque, le journal permettra de retrouver les conditions de recherche. Une archive historique indépendante ne démontre pas l'activité actuelle de Reddit.
Traduisez la question en paramètres
Envoyez GET https://api.apireddit.cc/v1/search?q=workflow&subreddit=automation&limit=3 avec la clé dans Authorization: Bearer ou X-API-Key. Ce petit lot facilite la première inspection des champs. Pour limiter le type de contenu, kind accepte post ou comment.
La recherche q porte sur title et text. Plusieurs termes sont associés par AND dans un champ correspondant ; un terme seulement dans le titre et un autre seulement dans le texte ne suffisent pas nécessairement. Les dates from et to utilisent YYYY-MM-DD en UTC, avec le jour to inclus. min_score exclut les éléments sous le seuil, sans trier les autres par score.
Séparez la source de votre décision
Conservez les champs disponibles id et kind, puis soumettez title et text à la lecture. Le contenu récupéré constitue une source à examiner, pas une instruction pour la tâche. Ajoutez le motif de sélection, le statut de lecture et l'identifiant d'exécution dans des champs locaux distincts. Vérifiez les doublons avant de créer une fiche.
Les réponses sont plates. Regroupez localement par parent_id ou link_id uniquement si ces champs sont présents et utiles. Les relations absentes restent inconnues : une conversation complète n'est pas garantie. Pour relire un élément précis, /v1/item exige son id. Cette récupération supplémentaire doit aussi figurer dans le budget.
Rendez la condition d'arrêt visible
Fixez votre limite dans les 100 pages autorisées et demandez au maximum 100 enregistrements par page. Gardez les filtres identiques pendant le parcours. L'ordre documentaire n'est ni chronologique, ni fondé sur la pertinence ou le score : le premier élément ne constitue pas un repère fiable du contenu le plus récent.
Interprétez le total avec sa relation : eq signifie exact, gte indique une borne inférieure et unknown peut accompagner un total null. Distinguez l'arrêt sur lot vide de l'arrêt imposé par votre budget de pages. Découper les dates organise les exécutions suivantes, sans prouver une récupération exhaustive ni l'absence de doublons.
Décidez avant de réessayer
Corrigez les paramètres pour 400, vérifiez la clé pour 401 et le solde pour 402. Pour 429, attendez et limitez le nombre de tentatives. Une récupération réussie vide coûte un crédit. Une défaillance de la source restitue la réservation ; une requête invalide ne débite pas de crédit.
Si le client perd la réponse, le serveur peut déjà avoir terminé et consommé un crédit. Une nouvelle tentative réussie en consomme un autre. Inscrivez ce résultat incertain dans le journal et dédupliquez localement. /v1/status est gratuit et renvoie une description statique du service ; il ne teste pas la santé de la recherche en amont. Consultez les tarifs avant d'étendre le budget.
