Reddit Fetch
Reddit Fetch
Seleção de idioma

Comece com uma prévia de três comentários históricos

Monte uma prévia de comentários históricos com fetch no servidor. Confira HTTP e JSON, mantenha a chave privada e diferencie retorno vazio de falha.

Obter chave API

Exemplo de requisição

JavaScript

const response = await fetch("https://api.redditfetch.com/v1/comments?subreddit=javascript&limit=3", {
  headers: { Authorization: "Bearer YOUR_API_KEY" }
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const payload = await response.json();
console.log(payload);

Dê uma tarefa pequena à primeira tela

Uma prévia pode começar mostrando os fragmentos disponíveis e explicando quando não há conteúdo para exibir. Reddit Fetch permite que aplicações JavaScript consultem um arquivo histórico independente do Reddit. Escolha uma comunidade e decida como a tela indicará texto ausente antes de fazer a chamada. Assim, cada decisão sobre os registros atende a uma necessidade concreta do aplicativo.

O exemplo usa GET https://api.redditfetch.com/v1/comments?subreddit=javascript&limit=3. O parâmetro subreddit=javascript escolhe a comunidade e limit=3 pede no máximo três comentários. Esse limite não promete três cartões preenchidos: a resposta pode trazer menos registros ou nenhum. Os comentários também não precisam pertencer à mesma conversa. A posição lado a lado na tela não estabelece uma relação entre eles.

Faça a chamada dentro do seu serviço

Execute fetch no processo Node.js e carregue REDDIT_FETCH_API_KEY de uma configuração privada do servidor. Confira se o valor existe antes de chamar o arquivo. Tanto Authorization: Bearer <key> quanto X-API-Key: <key> são aceitos. O marcador representa seu segredo salvo; não é uma credencial para distribuir no JavaScript enviado ao navegador de cada visitante.

Mantenha o destino fixo nesta primeira experiência. Depois de verificar a resposta, o servidor pode devolver ao navegador apenas uma representação preparada para a prévia. Não encaminhe a chave nem use uma URL arbitrária do visitante como destino de uma chamada autenticada. Defina também quem pode atualizar a tela: esconder o segredo não limita sozinho o consumo da sua rota.

Explique o resultado que realmente ocorreu

Uma promessa fetch resolvida não confirma sucesso HTTP. Verifique response.ok antes de tratar o corpo como comentários; depois decodifique o JSON e confira os campos necessários. Uma exceção de rede é outro resultado, e a decodificação pode falhar mesmo quando houve resposta. Esses casos precisam de tratamento próprio, em vez de uma mensagem genérica dizendo que a lista está vazia.

Os comentários chegam como fragmentos planos. Examine o texto disponível, escolha uma indicação local para valores ausentes e exiba o conteúdo como texto. Carregando, prévia disponível, retorno vazio e falha são estados definidos pelo seu aplicativo. Um conjunto vazio no arquivo não demonstra que a comunidade não tenha comentários, e três fragmentos não formam uma conversa completa.

Escolha quando atualizar de novo

Cada recuperação bem-sucedida custa um crédito, inclusive quando vazia. O preço é $1 por 1000 solicitações bem-sucedidas; a recarga mínima de $50 compra 50000 créditos pagos. Créditos de teste dependem da elegibilidade. Uma cópia local pode ser reutilizada sem nova recuperação, mas uma atualização bem-sucedida consome outro crédito mesmo que o texto exibido continue igual.

O arquivo é independente, sem vínculo oficial com o Reddit ou transmissão ao vivo. Não há garantia de cobertura completa, disponibilidade permanente ou respostas imutáveis. Identifique a prévia como histórica e não apresente a ordem do arquivo como ordem dos mais recentes. Vá à página da chave para configurar o servidor, ao guia para tratar falhas e à documentação para conferir o formato da resposta.