Définir le travail autorisé par une action
Une fonction qui propose des références sur l’onboarding commence par une décision : combien de requêtes d’archive une action utilisateur peut-elle déclencher ? Reddit API Gateway donne aux équipes d’infrastructure produit accès à une archive historique indépendante de Reddit, sans affiliation officielle ni données en direct. L’exemple SaaS aide à fixer ce périmètre avant d’ouvrir la fonction aux clients.
Imaginez un écran proposant quelques mentions historiques. Votre backend vérifie les droits de l’utilisateur, puis accepte un traitement borné. Les règles par utilisateur et les plafonds de dépense relèvent de votre application. La clé identifie le compte du domaine qui paie les lectures ; elle ne distribue ni les rôles du produit ni son solde entre vos clients.
Demander trois enregistrements, quitte à n’en recevoir aucun
L’exemple est GET https://api.redditapigateway.com/v1/search?q=onboarding&subreddit=SaaS&limit=3. q=onboarding effectue une recherche textuelle, subreddit=SaaS limite la communauté et limit=3 demande au maximum trois enregistrements. Sans kind, publications et commentaires peuvent apparaître. La requête ne classe pas automatiquement des conseils d’accueil des utilisateurs et ne garantit pas de contenu pertinent. Transmettez côté serveur X-API-Key: <clé> ou Authorization: Bearer <clé> ; les deux formes utilisent la clé de l’archive.
Extrait synthétique, uniquement démonstratif et sans requête réelle : {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Le solde est fictif. La liste vide illustre une réussite qui consomme un crédit, même si votre produit ne conserve aucun enregistrement. Sauvegardez la réponse réellement reçue avant de transformer les champs ou d’avancer votre progression locale. Une erreur de transformation ou de stockage local n’annule pas une réussite distante facturée.
Tenir le compte des tentatives
Pour préparer le budget, autorisez au plus trois tentatives de récupération par traitement. Trois requêtes réussies coûtent trois crédits, soit $0.003, même si aucun enregistrement ne convient à l’écran. Cette limite est votre règle locale. Comptez les changements de page et les relances, pas seulement les lignes finalement conservées.
Retravailler une réponse sauvegardée ne demande aucune nouvelle récupération. Demander un nouvel échantillon peut renvoyer d’autres données et coûte un crédit supplémentaire en cas de réussite. Si une actualisation déclenche du travail payant, faites-en un choix explicite de l’utilisateur plutôt qu’un effet implicite de l’ouverture d’un résultat.
Dire ce que représente la sélection
Les réponses de l’API contiennent des enregistrements plats. Lorsque parent_id et link_id sont présents, les clients peuvent regrouper les éléments localement, sans garantie de discussion ou d’ascendance complète. L’archive ne garantit ni couverture totale, ni résultats immuables, ni schéma constant, ni disponibilité permanente. Conservez ces limites avec l’échantillon reçu ; terminer une tâche de votre produit ne prouve pas que toute l’histoire de Reddit a été récupérée.
Présentez les données comme l’échantillon reçu. Une page courte ne démontre pas l’absence d’autres discussions sur l’onboarding dans SaaS. Un regroupement local ne reconstitue pas non plus une conversation complète. Conservez les paramètres et le contexte de récupération avec la sélection pour qu’un collègue comprenne ce qui a été examiné.
Passer de l’échantillon à une fonction exploitée
Choisissez les filtres dans la documentation et dimensionnez les appels à partir de la page des tarifs. La page de clé prépare le compte et son financement ; le guide suit le secret à travers un traitement autorisé et son remplacement. Attribuez ces responsabilités avant de transformer l’exemple en une opération régulière du produit.
Avant d’ouvrir la fonction d’onboarding à davantage d’utilisateurs, suivez séparément les tentatives permises par action et le solde qui finance les appels. Une récupération réussie consomme un crédit, même sans donnée utilisable, au tarif de $1 pour 1000 réussites. L’achat minimal de $50 ajoute 50000 crédits, sans abonnement ni expiration des crédits achetés. Une requête invalide ne débite rien et un échec du service source rend la réservation. Si seule la réponse disparaît chez votre client, une réussite peut déjà avoir été facturée ; une relance réussie se paie à nouveau. Le suivi d’un traitement doit donc compter les appels, pas seulement les lignes affichées.
