Definisci prima cosa conta come osservazione
Formula una decisione verificabile: quali record ricevuti da r/science con replication parlano di ripetere uno studio? Scegli il record come unità e decidi se includere post, commenti o entrambi. La query seleziona testi candidati; la lettura locale assegna categorie. Una parola trovata non dimostra la replica riuscita di un risultato scientifico.
L’API accede a un archivio storico indipendente, non ufficiale né affiliato a Reddit e senza aggiornamenti in diretta. Il carattere storico non rende immutabili i record. Non sono garantite copertura completa o risposte identiche alla query successiva. Definisci l’esperimento sul materiale effettivamente ricevuto, senza attribuirgli automaticamente le proprietà dell’intera comunità o di una popolazione più ampia. Dichiara i limiti delle tue osservazioni.
Fissa regole locali per campi assenti, duplicati ricevuti e riferimenti non risolti. Separa queste decisioni dai parametri dell’API. Registra i cambiamenti come versioni del protocollo, invece di adattare silenziosamente i criteri dopo aver visto i risultati. La documentazione deve permettere di esaminare le scelte compiute, senza affermare che la raccolta è completa o che l’esperimento è privo di distorsioni nella selezione.
Registra la query realmente eseguita
Parti da GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3, l’esempio della pagina iniziale. Salva percorso e parametri effettivi, includendo i valori predefiniti usati. Autentica dal server con X-API-Key: <chiave> oppure Authorization: Bearer <chiave>, ma rimuovi i segreti dai file condivisi. La pagina della chiave spiega l’emissione prima del pagamento e la gestione dell’accesso all’archivio.
Per provare replication crisis, aggiungi una modifica al registro delle query. q cerca in title e text con l’operatore and all’interno del campo corrispondente; non combina semplicemente una parola del titolo con una del corpo. Conserva separatamente le risposte delle due formulazioni. Nessuna copre tutto il lessico della replicazione scientifica.
Salva ogni risposta ricevuta prima di pulire o aggiungere campi. Annota separatamente ora di esecuzione del client, stato HTTP e limiti di paginazione incontrati. from e to filtrano created_utc con YYYY-MM-DD UTC e includono tutto l’ultimo giorno; non indicano l’ingresso nell’archivio. I record sono piatti e possono variare: parent_id o link_id presenti consentono relazioni locali, senza conversazione completa garantita e senza filtri per questi identificatori.
Annota il senso senza sostituire l’originale
Crea una tabella locale con l’identificatore disponibile, una categoria e la motivazione. Puoi iniziare distinguendo ripetizione di studi, replicazione biologica e contesto insufficiente. Sono etichette tue, non campi dell’API. Lascia i casi ambigui aperti alla revisione e conserva il testo originale accanto alla versione preparata per l’analisi.
Puoi calcolare un hash del file salvato e annotarne il nome insieme alle versioni del codice e delle dipendenze. L’hash identifica i byte della tua copia; non dimostra autenticità del contenuto, rappresentatività o integrità dell’archivio remoto. Mantieni un file originale e uno derivato, documentando la trasformazione che li collega. Questa organizzazione è lavoro del team, non una funzione di conservazione o versionamento fornita dall’API.
Confronta una modifica alla volta
Per verificare l’analisi usa prima i file salvati e la versione documentata del codice. Se il tuo metodo usa casualità, annota la configurazione e le condizioni dell’ambiente. Controlla se le differenze dipendono da dati, regole o strumenti. Questo permette di indagare le discrepanze; conservare un file non garantisce risultati identici in qualsiasi ambiente né certifica la validità di una conclusione scientifica.
Mantieni dapprima fissa la copia salvata e cambia solo la regola di annotazione. Spiega quali decisioni cambiano e perché. Un nuovo recupero remoto richiede una voce separata. Se cambiano insieme dati e regole, la differenza nei conteggi non può essere attribuita a una sola delle due modifiche.
Un nuovo recupero è un’altra osservazione dell’archivio. limit e page vanno da 1 a 100, con una pagina per richiesta; _doc non è cronologia, rilevanza o punteggio. Leggi total con relation: eq è esatto per la query, gte è limite inferiore e unknown è un totale non affidabile, eventualmente null. Scorrere pagine, suddividere date o rimuovere duplicati non prova esaustività o immutabilità. /v1/subreddits accetta soltanto prefix e limit per i nomi, senza page.
Chiudi con limiti e casi irrisolti
Concludi con parametri, pagine ricevute, record conservati, esclusioni e casi irrisolti. Indica il motivo dell’arresto e la versione del criterio che ha prodotto i conteggi. Limita le conclusioni al materiale: un totale sconosciuto, contesto mancante o una lacuna dell’archivio non dimostrano il silenzio della comunità.
Prevedi un credito per ogni recupero riuscito, anche vuoto o ripetuto: $1 per 1000 richieste e ricarica minima di $50. I 100 crediti di prova sono condizionati. Le richieste non valide non addebitano; i guasti a monte restituiscono la prenotazione. Perdere la risposta può nascondere un successo fatturato, e un errore locale non lo rimborsa. Consulta prezzi e documentazione: correggi 400, verifica chiave con 401, saldo con 402 e limita i tentativi con attesa per 429. /v1/status non verifica la ricerca né riproduce risultati.
