Classificare la risposta prima di ripetere
Questo servizio è un archivio storico indipendente e non l’API ufficiale di Reddit. Non supporta Reddit OAuth, pubblicazione, voti o messaggi privati. L’accesso si limita alla lettura dei dati disponibili, senza flusso in diretta. Ripetere una lettura non modifica il contenuto di Reddit, ma può consumare un altro credito e non garantisce risultati identici. Separa successo remoto, ricezione del client e trasformazione locale dei record.
Inizia con https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3, l’esempio della pagina iniziale. subreddit sceglie devops e limit chiede fino a tre commenti. Usa X-API-Key: <chiave> oppure Authorization: Bearer <chiave> sul server: entrambe le intestazioni sono ammesse. Non inviare un token Reddit OAuth. Controlla lo stato HTTP prima di interpretare il corpo come dati e conserva la risposta ricevuta prima di aggiornare l’avanzamento locale.
Con HTTP 400 correggi i parametri invece di ripetere all’infinito la stessa richiesta non valida. Le ricerche di contenuto ammettono q, subreddit, author, kind, from, to, min_score, limit e page; kind usa post o comment. from/to seguono YYYY-MM-DD in UTC e filtrano created_utc, includendo tutto il giorno finale. /v1/item richiede id e /v1/subreddits soltanto prefix e limit. Consulta la documentazione prima di trasferire filtri tra percorsi.
Correggere credenziali e saldo prima della prossima richiesta
HTTP 401 indica una chiave mancante o non valida. Verifica dominio, nome dell’intestazione e segreto configurato senza stamparlo nei registri. Una risposta vuota riuscita non segnala un problema di chiave. Per rigenerarla, accedi al pannello della pagina Ottieni una chiave API e conferma la password: la precedente diventa subito non valida. Aggiorna i client interessati. Non sono disponibili ripristino della password o invio della chiave via email.
HTTP 402 indica saldo insufficiente. Sospendi le attività che richiedono crediti e consulta il pannello account; lo stato pubblico non mostra il saldo. Per acquistare, accedi e crea una fattura prima di trasferire il suo importo esatto sulla rete indicata. Poi presenta l’hash della transazione per la verifica. Attendi il saldo accreditato senza presumere un termine: pagare o inviare un hash non prova da solo che la prossima richiesta sia autorizzata.
HTTP 429 indica un limite di frequenza. Puoi fissare un numero massimo di nuovi tentativi con pause crescenti e interrompere il lavoro al termine di quel budget. È una scelta del client, senza garanzia di ripresa successiva. Evita che ogni livello dell’applicazione crei una seconda catena automatica di ripetizioni. I controlli di idoneità al credito di prova riguardano la rete e non descrivono una categoria a pagamento o un meccanismo di priorità.
Separare costo, trasporto e trattamento dei dati
Un recupero riuscito costa un credito, anche vuoto. Le richieste non valide non addebitano saldo; gli errori del servizio a monte restituiscono la prenotazione. Una disconnessione o un timeout nel client può però seguire un successo già addebitato. Un altro tentativo riuscito costa un altro credito. Nemmeno un errore del tuo database dopo la ricezione di una risposta valida provoca un rimborso automatico. Consulta i prezzi per includere prove e ripetizioni nel budget.
Non usare /v1/status come prova di salute della ricerca o validità della chiave. Pubblico, gratuito e statico, conferma soltanto la risposta HTTP. Per le pagine di contenuto, limit e page vanno da 1 a 100; min_score filtra senza ordinare e _doc non rappresenta tempo, rilevanza o punteggio. eq indica il totale esatto della query, gte un limite inferiore e unknown un totale non affidabile, eventualmente null. Nessuno certifica copertura completa.
Convalida data e i campi necessari all’applicazione. I record sono piatti; parent_id o link_id presenti permettono associazioni locali senza conversazione completa garantita. Salva i dati prima di segnare la pagina come conclusa. Non presumere che ripetere completi i riferimenti assenti, mantenga lo stesso ordine o ritrovi tutti i record mancanti. Suddividere i periodi o rimuovere duplicati localmente organizza il lavoro, ma non dimostra un download esaustivo dell’archivio.
