Due operazioni con significati diversi
Reddit Gateway offre ai team che gestiscono piattaforme backend un accesso indipendente a un archivio storico di Reddit. Non è un servizio ufficiale di Reddit, un flusso in tempo reale o un intermediario trasparente per qualsiasi operazione del sito. Non consente di pubblicare, votare o inviare messaggi privati. Per progettare l’integrazione occorre separare due operazioni: verificare la risposta HTTP pubblica e recuperare dati storici attraverso percorsi protetti.
Il percorso GET https://api.redditgateway.com/v1/status è pubblico, non richiede una chiave e non consuma crediti. La risposta statica indica che l’applicazione HTTP risponde. Non verifica il motore di ricerca né la disponibilità dei dati dell’archivio. Non convalida una chiave e non restituisce saldo o stato dei pagamenti. Un indicatore costruito sulla sua risposta deve quindi descrivere questa portata limitata, senza trasformarla in una garanzia di ricerca operativa.
Una ricerca protetta richiede invece una chiave valida per questo dominio e crediti sufficienti. Una risposta riuscita riguarda quella richiesta concreta: non dimostra la copertura completa di una comunità o l’esistenza di ogni record atteso. L’archivio non garantisce date di copertura, risultati immutabili o uno schema invariabile. La tua applicazione deve gestire assenze e campi facoltativi e descrivere i limiti del campione effettivamente ricevuto.
Leggere una pagina di ricerca senza sovrainterpretarla
L’esempio è GET https://api.redditgateway.com/v1/search?q=database&subreddit=backend&limit=3. Il parametro q=database esprime la ricerca testuale, subreddit=backend seleziona la comunità e limit=3 richiede al massimo tre record. Senza kind, la ricerca può includere sia post sia commenti. Non sono garantiti tre risultati o una particolare rilevanza. Dal tuo server puoi inviare X-API-Key: <key> oppure Authorization: Bearer <key>: entrambe le forme sono supportate per il recupero protetto.
Questo estratto di risposta è sintetico e soltanto dimostrativo: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Non deriva da una chiamata eseguita e balance=99 non è un saldo osservato. La lista vuota illustra un recupero riuscito senza corrispondenze, che costa comunque un credito. Un primo passo utile nel tuo sistema è verificare e conservare la pagina ricevuta prima di richiederne un’altra a pagamento.
I record sono piatti. Quando contengono parent_id o link_id, puoi collegare localmente i record ricevuti, senza ottenere per questo una discussione completa. L’ordine interno _doc non corrisponde a un ordinamento per data, rilevanza o punteggio; min_score applica soltanto una soglia. limit e page ammettono valori da 1 a 100. Esaurire le pagine accessibili non prova una copertura esaustiva e non rende identiche le risposte di esecuzioni successive.
Gestire chiave e pagamenti nel percorso corretto
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.
