Classer la réponse avant de réessayer
Ce service est une archive historique indépendante et non l’API officielle de Reddit. Il ne propose ni Reddit OAuth, ni publication, ni votes, ni messages privés. L’accès se limite à la lecture des données disponibles, sans flux en direct. Répéter une lecture ne modifie pas le contenu de Reddit, mais peut consommer un autre crédit et ne garantit pas des résultats identiques. Séparez réussite distante, réception côté client et transformation locale des données.
Commencez par https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3, l’exemple de l’accueil. subreddit choisit devops et limit demande jusqu’à trois commentaires. Utilisez X-API-Key: <clé> ou Authorization: Bearer <clé> sur votre serveur ; les deux en-têtes sont acceptés. Ne transmettez pas de jeton Reddit OAuth. Vérifiez le statut HTTP avant d’interpréter le corps comme des données et conservez la réponse reçue avant d’avancer votre progression locale.
Avec HTTP 400, corrigez les paramètres plutôt que répéter sans fin la même requête invalide. Les recherches de contenu acceptent q, subreddit, author, kind, from, to, min_score, limit et page ; kind utilise post ou comment. from/to suivent YYYY-MM-DD en UTC et filtrent created_utc, avec toute la journée finale incluse. /v1/item exige id et /v1/subreddits accepte seulement prefix et limit. Consultez la documentation avant de déplacer des filtres entre routes.
Corriger les identifiants et le solde
HTTP 401 indique une clé absente ou invalide. Vérifiez domaine, nom d’en-tête et secret configuré sans l’imprimer dans les journaux. Une réponse vide réussie n’indique pas un problème de clé. Pour la remplacer, connectez-vous au panneau de la page Obtenir une clé API et confirmez le mot de passe : l’ancienne devient immédiatement invalide. Mettez à jour les clients concernés. Il n’existe ni réinitialisation du mot de passe ni livraison de clé par e-mail.
HTTP 402 indique un solde insuffisant. Suspendez les travaux qui exigent des crédits et consultez le panneau du compte ; le statut public ne montre pas le solde. Pour acheter, connectez-vous et créez une facture avant de transférer son montant exact sur le réseau indiqué. Soumettez ensuite le hachage de transaction à vérification. Attendez le solde crédité sans présumer de délai : payer ou envoyer un hachage ne prouve pas, à lui seul, que le prochain appel sera autorisé.
HTTP 429 indique une limite de fréquence. Vous pouvez fixer un nombre maximal de nouvelles tentatives avec des pauses croissantes et arrêter le travail une fois ce budget épuisé. C’est un choix du client, sans garantie de reprise ultérieure. Évitez que chaque couche de l’application lance une deuxième chaîne automatique de répétitions. Les contrôles d’éligibilité au crédit d’essai concernent le réseau et ne décrivent ni catégorie payante ni mécanisme de priorité.
Séparer coût, transport et traitement des données
Une récupération réussie coûte un crédit, même vide. Les requêtes invalides ne débitent pas le solde ; les échecs du service source restituent la réservation. Une déconnexion ou un délai dépassé côté client peut survenir après une réussite facturée. Un autre essai réussi coûte un autre crédit. Une erreur de votre base de données après réception d’une réponse valide ne déclenche pas non plus de remboursement automatique. Consultez les tarifs pour budgéter tests et répétitions.
N’utilisez pas /v1/status comme preuve de santé de la recherche ou de validité de la clé. Public, gratuit et statique, il confirme seulement la réponse HTTP. Pour les pages de contenu, limit et page vont de 1 à 100 ; min_score filtre sans trier et _doc ne représente ni temps, ni pertinence, ni score. eq exprime un total exact pour la requête, gte une borne inférieure et unknown un total non fiable, éventuellement null. Aucun ne certifie une couverture complète.
Validez data et les champs nécessaires à votre application. Les enregistrements sont plats ; parent_id ou link_id présents permettent des associations locales sans discussion complète garantie. Enregistrez les données avant de marquer la page comme terminée. Ne supposez pas qu’une répétition comble les références absentes, préserve le même ordre ou retrouve tout ce qui manque. Diviser les périodes ou retirer les doublons localement organise le travail, sans prouver un téléchargement exhaustif de l’archive.
