Filtrage Temporel et Précision des Données
Reddit Posts API interroge des archives historiques indépendantes, sans affiliation officielle avec Reddit et sans données en temps réel. Ni couverture complète, ni immutabilité, ni disponibilité permanente ne sont garanties. Commencez par examiner les textes disponibles avant de définir une étude sur du matériel photo. Un enregistrement ne démontre pas la présence de toutes les publications d’une période ou l’état actuel de la page originale.
Essayez GET https://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3. subreddit choisit la communauté, min_score exige un score minimal et limit demande jusqu’à trois publications. Cela ne classe pas les résultats par popularité et ne filtre pas automatiquement appareils et objectifs. Examinez les textes, consignez vos critères et notez les exclusions. Une réponse réussie vide coûte elle aussi un crédit.
Utilisez from et to au format YYYY-MM-DD en UTC, avec to inclusif pour toute la journée finale. Ces paramètres n’acceptent pas d’heure à l’intérieur d’une journée. Si votre question part de dates locales, documentez leur correspondance avec les jours UTC, sans présenter cette décision comme un filtrage natif selon l’heure locale de chaque auteur.
Limites de Pagination et Exhaustivité
Pour des périodes consécutives, le from suivant peut être le lendemain du to précédent. Réutiliser la même date aux deux limites crée un chevauchement, car to est inclusif. Cette règle organise le travail, sans prouver absence de doublons ou de lacunes entre les enregistrements reçus. Notez les filtres et dates d’exécution avant de comparer des volumes historiques.
L'itération bornée des pages ne garantit pas une ingestion complète ou exhaustive de toutes les publications correspondant aux critères. L'ordre de récupération est basé sur la structure interne de la base de données, ce qui signifie qu'aucune promesse de couverture totale n'est formulée par le service.
eq signifie un total exact pour la recherche, gte une borne inférieure et unknown l’absence de total fiable, éventuellement nul. Un total exact ne démontre pas que tous les enregistrements ont été téléchargés. Les limites sont de 100 enregistrements par requête et 100 pages par recherche. L’ordre _doc est documentaire interne, ni chronologique ni fondé sur la pertinence ou le score.
Gestion des Erreurs et États du Service
Envoyez Authorization: Bearer <clé> ou X-API-Key: <clé> depuis le serveur. 400 indique des paramètres invalides, 401 une clé absente ou invalide, 402 un solde insuffisant et 429 une limite de fréquence. Les requêtes invalides ne débitent pas le solde ; les erreurs du fournisseur restituent la réserve. Une interruption du client peut suivre un succès facturé et une nouvelle tentative réussie coûte un autre crédit.
Les réponses sont plates. Regroupez parent_id ou link_id lorsqu’ils apparaissent sans supposer une conversation complète ; ces champs ne sont pas des filtres exposés. Pour une chronologie, triez localement les champs disponibles en signalant les valeurs absentes. Sauvegardez les réponses originales et les règles avant d’avancer un point de contrôle. Ce dernier ne fige pas les pages ou les réponses futures.
Consultez Documentation pour les filtres, Tarification pour le budget et la page des clés pour l’accès. /v1/status est public et gratuit, mais sa déclaration statique et sa réponse HTTP ne testent pas la recherche ou la présence des enregistrements. Rejouer vos transformations sur des fichiers conservés vérifie votre traitement local, sans rendre l’archive immuable ni démontrer une collecte exhaustive.
