Esempio di richiesta
cURL
curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditstreamapi.com/v1/posts?subreddit=datasets&limit=3&page=2"Richieste separate, non un flusso di eventi
Reddit Stream API offre accesso in lettura a un archivio storico indipendente di Reddit per chi progetta elaborazioni in lotti. Non è un servizio ufficiale né affiliato a Reddit. Il nome non descrive un flusso in diretta tramite SSE o WebSocket: ogni GET chiede una risposta limitata. Il servizio non offre nemmeno Reddit OAuth, pubblicazioni, voti o messaggi privati. La tua applicazione pianifica le attività e decide quali risposte conservare ed elaborare.
Il lavoro può essere organizzato in finestre di query, ma non segue automaticamente l’attività attuale di Reddit. Ripetere periodicamente le richieste è una scelta del client, non un abbonamento a nuovi eventi. Record possono mancare, senza garanzie di copertura completa, risposte immutabili, schema fisso o disponibilità permanente. Una finestra elaborata indica il termine di un’attività locale, non che tutti i messaggi storici del periodo siano stati recuperati.
Le risposte sono record piatti, senza alberi di discussione assemblati dal server. parent_id o link_id presenti permettono associazioni locali, senza contesto completo garantito. La consegna segue _doc, un ordine interno, non tempo, rilevanza o punteggio. min_score applica una soglia numerica senza ordinare. Il numero di pagina non è un orario né una posizione permanente in un registro di eventi.
Una pagina per verificare il lavoro del client
L’esempio è GET https://api.redditstreamapi.com/v1/posts?subreddit=datasets&limit=3&page=2. subreddit=datasets limita la comunità, limit=3 chiede fino a tre post e page=2 seleziona la seconda pagina della query. Non rappresenta il secondo periodo temporale né i prossimi tre eventi in diretta. Autentica dal server con X-API-Key: <chiave> oppure Authorization: Bearer <chiave>; entrambe le intestazioni usano la chiave di questo dominio.
Estratto sintetico, soltanto dimostrativo e senza richiesta reale: {"data":[],"pagination":{"page":2,"limit":3,"total":null,"relation":"unknown","has_more":false,"window_exhausted":false},"credits":{"cost":1,"balance":99}}. Il saldo è fittizio. Una pagina successiva vuota non stabilisce un totale esatto pari a zero: unknown segnala l’assenza di un totale affidabile. Questo successo vuoto costa un credito. Non prova neppure che datasets non abbia post storici fuori dalla risposta ricevuta.
Salva la risposta prima di trasformare i record e aggiornare l’avanzamento. Nei percorsi di contenuto, limit e page vanno da 1 a 100, con una pagina per richiesta. Conserva has_more e window_exhausted come segnali dei limiti incontrati, senza inventare un cursore oltre la pagina 100. Suddividere date o rimuovere duplicati localmente può organizzare il lavoro, senza garantire copertura esaustiva, unicità o stabilità quando la query viene ripetuta.
Accesso, crediti e pagamenti
La registrazione usa email e password di 12–72 byte UTF-8. La chiave viene mostrata una sola volta subito dopo la registrazione riuscita, prima di qualsiasi ricarica obbligatoria: conservala allora in modo sicuro. I possibili 100 crediti di prova dipendono dai controlli antiabuso a livello di rete. Account, chiave e saldo restano specifici del dominio. Il pannello nella pagina Ottieni una chiave API permette di accedere, consultare il saldo, creare fatture e rigenerare la chiave.
Ogni recupero protetto riuscito costa un credito, anche se vuoto. Un credito vale $0.001 e $1 corrisponde a 1000 crediti. La ricarica pagata minima è $50 per 50000 crediti; quelli acquistati non scadono e non richiedono abbonamenti. Le richieste non valide non comportano addebito e un errore del servizio a monte restituisce la prenotazione. Un’interruzione della ricezione può però seguire un successo già addebitato sul server: una ripetizione riuscita costa un altro credito.
Prima del trasferimento crea una fattura nel pannello autenticato. Sono supportati USDT su TRON come TRC20 e USDC su Ethereum Mainnet come ERC20. Usa destinatario e importo esatti della fattura corrente, quindi invia l’hash della transazione esistente per la verifica. L’accredito richiede un trasferimento reale, confermato e corrispondente; non è garantita una conferma immediata. Queste operazioni di account e pagamento sono separate dal percorso pubblico di stato.
