Autenticazione e Integrazione Sicura
Invia richieste GET a api.redditpostsapi.com con Authorization: Bearer <chiave> oppure X-API-Key: <chiave> per i recuperi autenticati. Sono supportate entrambe le opzioni, senza firma crittografica delle richieste. /v1/status è pubblico e non richiede chiave. La sessione del pannello usa un cookie Secure HttpOnly distinto da queste intestazioni. Chiave e saldo appartengono al dominio, senza stabilire diritti sui testi recuperati.
La chiave appare una sola volta immediatamente alla registrazione, prima del pagamento. Conservala sul server, fuori da file di analisi e diagnostica pubblica. La rigenerazione richiede accesso e conferma della password, invalidando subito quella precedente. Non ci sono reimpostazione della password o invio automatico di chiavi per email. La chiave originale non viene persistita nell’archiviazione del browser.
Quando la chiave è assente o non valida, il server restituisce un errore 401 immediatamente. Questo codice indica chiaramente che le credenziali non sono riconosciute dal sistema di autenticazione. È fondamentale verificare che l’intestazione sia formattata correttamente per evitare blocchi inutili durante il flusso di interrogazione dei dati archiviati.
Filtri, Endpoint e Struttura dei Dati
La ricerca accetta q, subreddit, author, kind, from, to, min_score, limit e page. kind usa post o comment; /v1/posts seleziona pubblicazioni e /v1/comments commenti. Solo /v1/item richiede id; /v1/subreddits accetta prefix e limit per esplorare nomi, senza conteggi globali esatti garantiti. Non sono disponibili filtri di query per parent_id o link_id.
Ogni risposta contiene record piatti, non alberi di thread assemblati dal server. I campi parent_id e link_id, se presenti, possono essere raggruppati localmente dal client, ma questo non garantisce una gerarchia completa o l’assenza di nodi mancanti. L’ordine dei documenti nell’archivio segue l’indicizzazione interna e non è né cronologico né basato sulla pertinenza.
from e to sono date YYYY-MM-DD in UTC, con to inclusivo per tutto il giorno finale, senza orari intragiornalieri. limit e page vanno da 1 a 100: fino a 100 record per richiesta e 100 pagine per query. eq indica un totale esatto di record per la query, gte un limite inferiore e unknown l’assenza di totale affidabile, eventualmente nullo. Non sono conteggi di pagine o prove di copertura completa.
Gestione Crediti e Codici di Errore
Ogni recupero riuscito costa un credito, anche vuoto: $1 per 1000 richieste. Le richieste non valide non addebitano saldo e gli errori del fornitore di ricerca restituiscono la riserva. Un’interruzione del client può seguire un successo addebitato sul server; una ripetizione riuscita costa un altro credito. La ricarica minima di $50 acquista 50000 crediti. La prova di 100 crediti è condizionata ai controlli contro gli abusi della rete.
400 indica parametri non validi, 401 una chiave assente o non valida, 402 saldo insufficiente e 429 un limite di frequenza. Controlla la causa prima di ripetere e verifica lo stato HTTP prima di trattare il corpo come record. Per pagare, accedi e crea una fattura, segui destinatario e importo esatti e richiedi verifica con l’hash. Solo un trasferimento autentico confermato aggiunge saldo, senza tempi garantiti.
/v1/status è pubblico e non addebitato: restituisce una dichiarazione statica sull’ambito storico e indica che l’applicazione HTTP risponde. Non verifica ricerca, presenza dei record o velocità di recupero. Una data delimita la query senza garantire completezza. Conserva risposte originali e criteri prima di avanzare il checkpoint; il numero di pagina non congela lo stato dell’archivio.
Controllare il campione di photography
Comincia da /v1/posts?subreddit=photography&min_score=10&limit=3. Esamina i testi per decidere quali trattano di attrezzatura: il punteggio non lo garantisce. Aggiungi from e to e annota il giorno finale inclusivo. Per intervalli consecutivi, il from seguente può essere il giorno dopo il precedente to. Questo organizza i confini, senza provare assenza di duplicati o lacune. Reimpiegare file conservati verifica l’analisi locale, non risultati futuri identici.
