Définir un résultat acceptable
Choisissez le traitement qui utilise les anciennes publications de dataengineering. Notez ses champs obligatoires, son comportement sans texte et sa dépendance à l’ordre. Pour chaque exigence, décidez si elle est satisfaite directement, traitée localement ou exclue de la migration. Une réponse HTTP réussie documente ainsi une lecture précise, pas la compatibilité du client entier. Reddit Proxy fournit des archives historiques indépendantes, pas l’API officielle ni l’état actuel de Reddit.
Enregistrer une page avec la nouvelle clé
Exécutez GET https://api.redditproxy.com/v1/posts?subreddit=dataengineering&limit=3 avec X-API-Key: <clé> ou Authorization: Bearer <clé>. Les deux acceptent la clé d’archives de redditproxy.com, pas un jeton Reddit OAuth. Conservez paramètres et réponse pour travailler localement ; excluez le secret des fichiers de diagnostic.
Le lecteur de publications utilise /v1/posts ; une liste de commentaires correspond à /v1/comments, la recherche à /v1/search et un élément connu à /v1/item?id=.... Ce sont des opérations distinctes. Une recherche individuelle ne récupère pas automatiquement une conversation complète et le service ne relaie pas toute URL de l’ancien client.
Convertir sans inventer de contexte
Validez le tableau data et les champs nécessaires au rapport. Distinguez valeur absente, chaîne vide, échec de conversion local et page vide réussie. Les enregistrements sont plats. Les parent_id et link_id présents permettent un regroupement local, mais ne sont pas des filtres et ne garantissent pas un fil complet. Rejouez la conversion sur la réponse enregistrée avant de récupérer davantage de pages.
Traduire le sens de chaque filtre
q recherche dans title et text avec AND entre les termes au sein d’un champ correspondant. Répartir les mots nécessaires entre ces deux champs ne suffit pas ; il ne s’agit pas d’un langage de requêtes arbitraire. from et to utilisent YYYY-MM-DD en UTC, toute la journée to étant incluse. min_score applique seulement un seuil numérique. L’ordre _doc n’exprime ni chronologie, ni pertinence, ni score ; un tri local réorganise uniquement les enregistrements reçus.
Revoir la condition d’arrêt de la pagination
Le maximum est de 100 enregistrements par requête et de 100 pages demandées séparément pour une recherche. Lisez total avec relation : eq indique un total exact, gte une borne inférieure et unknown un total non fiable, éventuellement null. Inconnu ne signifie pas zéro. Atteindre une limite ou découper les dates ne prouve ni l’exhaustivité ni l’absence de doublons. Notez les pages demandées et les questions de couverture.
Tester les erreurs avant de raccorder le rapport
Pour HTTP 400, corrigez les paramètres ; pour 401, vérifiez la clé, pour 402 le solde et pour 429 ralentissez les requêtes. Une récupération réussie coûte un crédit même vide. Les requêtes invalides ne débitent pas ; les pannes de la source restituent la réservation. Une réponse perdue côté client peut suivre un succès facturé ; une nouvelle tentative réussie coûte un autre crédit.
Comparez le rapport final aux exigences initiales. Un test local correct ne garantit pas des résultats futurs immuables. Gardez les écritures et l’état actuel hors de cet adaptateur. /v1/status expose seulement le périmètre statique et la réponse HTTP de l’application, pas la santé de la source. Documentation, tarifs et page de la clé couvrent respectivement le contrat, le budget et le compte.
