Authentification et Gestion des Comptes
Envoyez des requêtes GET à api.redditpostsapi.com avec Authorization: Bearer <clé> ou X-API-Key: <clé> pour les récupérations authentifiées. /v1/status est public et n’exige pas de clé. La session du panneau utilise un cookie Secure HttpOnly distinct de ces en-têtes. Conservez le secret sur le serveur, hors des fichiers d’analyse et journaux publics.
Les utilisateurs inscrits peuvent régénérer leur clé API après avoir confirmé leur mot de passe, ce qui invalide immédiatement l'ancienne clé. L'enregistrement de base se fait par e-mail et mot de passe, sans connexion via des portefeuilles ou Google. La clé est affichée une seule fois après l'inscription avant le paiement.
Clé et solde sont propres à redditpostsapi.com, sans partage entre marques. Un essai de 100 crédits peut être accordé selon les contrôles anti-abus du réseau, sans attribution garantie. La clé apparaît avant paiement. Pour recharger, connectez-vous et créez une facture, suivez son destinataire et montant exacts, puis fournissez le hash et demandez la vérification du transfert par le serveur.
Paramètres de Requête et Filtrage
Les filtres de recherche sont q, subreddit, author, kind, from, to, min_score, limit et page. kind accepte post ou comment. from et to sont YYYY-MM-DD en UTC, avec to inclusif pour toute la journée. Ils n’acceptent pas d’heure intrajournalière. Seul /v1/item exige id ; /v1/posts et /v1/comments ne l’exigent pas. /v1/subreddits accepte prefix et limit, sans agrégations globalement exactes garanties.
Le paramètre min_score agit exclusivement comme un filtre et non comme un contrôle de tri. L'ordre des documents dans l'archive est l'ordre interne et non un ordre chronologique ou de pertinence. Une limite de 100 enregistrements par requête et 100 pages par interrogation s'applique strictement aux appels successifs.
Dans les totaux, eq signifie un nombre exact pour la recherche, gte une borne inférieure et unknown l’absence de total fiable, éventuellement nul. Ni une valeur exacte ni le parcours des pages autorisées ne prouve une collecte exhaustive. Conservez les réponses et critères avant de déplacer votre point de contrôle ; celui-ci ne fige pas l’archive ou la composition des futures pages.
Gestion des Erreurs et Structure des Données
400 indique une requête invalide, 401 une clé absente ou invalide, 402 un solde insuffisant et 429 une limite de fréquence. Vérifiez la cause avant de répéter l’appel. Une récupération réussie coûte un crédit, même vide. Les requêtes invalides ne débitent pas le solde et les défaillances du fournisseur de recherche restituent la réserve. Une interruption du client peut suivre un succès facturé ; chaque nouvelle tentative réussie coûte un autre crédit.
Les réponses de l'API contiennent des enregistrements plats et non des arbres de fils assemblés par le serveur. Bien que les champs parent_id et link_id puissent être présents dans les enregistrements retournés, le client peut grouper localement ces éléments. Aucune garantie de complétude de l'histoire n'est fournie par le serveur.
Le point /v1/status est public et non facturé, car il retourne une divulgation statique de l'archive indépendante et confirme simplement la réponse du serveur HTTP. Il n'examine pas la santé du moteur de recherche ni la disponibilité des données spécifiques, contrairement à un tableau de bord opérationnel vert.
Examiner une période de photography
Commencez par /v1/posts?subreddit=photography&min_score=10&limit=3, puis ajoutez les dates correspondant à votre étude. Le seuil ne sélectionne pas automatiquement du matériel photo : examinez les textes et notez les exclusions. Si vous découpez les jours, le from suivant peut être le lendemain du to précédent. La fin inclusive organise les limites, sans prouver absence de lacunes ou doublons. Gardez la version des règles d’analyse avec les fichiers reçus.
