Definisci un risultato accettabile
Scegli il processo che utilizza i vecchi post di dataengineering. Annota campi obbligatori, comportamento in assenza di testo e dipendenza dall’ordine. Per ogni requisito decidi se è supportato direttamente, gestito localmente o escluso dalla migrazione. Una risposta HTTP riuscita dimostrerà così una lettura precisa, non la compatibilità dell’intero client. Reddit Proxy fornisce un archivio storico indipendente, non l’API ufficiale né lo stato attuale di Reddit.
Salva una pagina con la nuova chiave
Esegui GET https://api.redditproxy.com/v1/posts?subreddit=dataengineering&limit=3 con X-API-Key: <chiave> o Authorization: Bearer <chiave>. Entrambe accettano la chiave d’archivio di redditproxy.com, non un token Reddit OAuth. Conserva parametri e risposta per lavorare localmente; escludi il segreto dai file diagnostici.
Il lettore di post usa /v1/posts; una lista di commenti corrisponde a /v1/comments, la ricerca a /v1/search e un record noto a /v1/item?id=.... Sono operazioni distinte. Una ricerca individuale non recupera automaticamente una conversazione completa e il servizio non inoltra qualsiasi URL del vecchio client.
Converti senza inventare il contesto
Valida l’array data e i campi necessari al rapporto. Distingui valore assente, stringa vuota, errore di conversione locale e pagina vuota riuscita. I record sono piatti. parent_id e link_id permettono un raggruppamento locale quando presenti, ma non sono filtri e non garantiscono un’intera discussione. Ripeti la conversione sulla risposta salvata prima di recuperare altre pagine.
Traduci il significato dei filtri
q cerca in title e text con AND tra i termini all’interno di un campo corrispondente. Distribuire le parole richieste tra i due campi non basta; non si tratta di un linguaggio di query arbitrario. from e to usano YYYY-MM-DD in UTC, includendo tutto il giorno to. min_score applica solo una soglia numerica. L’ordine _doc non esprime cronologia, rilevanza o punteggio; un ordinamento locale modifica soltanto i record ricevuti.
Rivedi la condizione di fine paginazione
Il massimo è 100 record per richiesta e 100 pagine richieste separatamente per query. Leggi total insieme a relation: eq indica un totale esatto, gte un limite inferiore e unknown un totale non affidabile, eventualmente null. Sconosciuto non significa zero. Raggiungere il limite o dividere per date non dimostra copertura completa né assenza di duplicati. Registra le pagine richieste e le questioni di copertura ancora aperte.
Prova gli errori prima di collegare il rapporto
Con HTTP 400 correggi i parametri; con 401 verifica la chiave, con 402 il saldo e con 429 riduci la frequenza. Un recupero riuscito costa un credito anche se vuoto. Le richieste non valide non addebitano crediti; i guasti della fonte restituiscono la riserva. Una risposta persa dal client può seguire un successo addebitato; un altro tentativo riuscito costa un altro credito.
Confronta il rapporto finale con i requisiti iniziali. Un test locale corretto non garantisce risposte future immutabili. Lascia fuori dall’adattatore scrittura e stato attuale. /v1/status mostra solo ambito statico e risposta HTTP dell’applicazione, non la salute della fonte. Documentazione, prezzi e pagina della chiave descrivono contratto, budget e gestione dell’account.
