Desenhe a pergunta antes da tela
Defina o que uma busca útil significa para seu público. Um pesquisador que procura relatos antigos sobre um problema precisa saber a comunidade e o período consultados. Comece com esse contexto, em vez de oferecer um campo que pareça pesquisar toda a atividade atual do Reddit sem qualquer restrição de cobertura.
Monte uma consulta de referência combinando q com subreddit e datas. Escolha um intervalo que faça sentido para a pergunta e teste uma pequena amostra. Anote quais expressões foram usadas e por quê. Variações de vocabulário podem produzir amostras diferentes; a ferramenta não deve prometer entender automaticamente todos os sentidos de uma expressão.
Decida quais controles realmente ajudam o usuário. Um filtro de autor pode ser pertinente para uma tarefa específica, enquanto a pontuação mínima exclui registros abaixo de um limiar. Explique as consequências dessas escolhas. Não use min_score como sinônimo de qualidade verificada, sentimento positivo ou classificação por relevância dos resultados.
Implemente uma navegação que respeite os limites
Guarde a chave no servidor e use o cadastro para iniciar a integração; o pagamento vem depois da exibição da chave. Caso receba os créditos de teste condicionais, use-os para observar as respostas reais. Valide os filtros antes de enviar a requisição e registre o conjunto utilizado em cada busca.
Converta as datas escolhidas para YYYY-MM-DD em UTC e trate to como inclusivo. Ao trocar de página, mantenha os mesmos filtros para que a navegação continue a consulta original. Cada requisição admite até 100 registros e a consulta até 100 páginas. Sinalize esse limite sem dizer que o arquivo inteiro foi percorrido.
Mostre a relação do total junto ao número: eq significa exato para a consulta, gte representa um limite inferior e unknown não oferece total confiável. Se não houver total utilizável, prefira uma navegação que não dependa dele. A ordem documental do arquivo também impede prometer que a primeira página contém os itens mais recentes.
Teste a apresentação e o orçamento
Crie mensagens diferentes para uma resposta vazia e uma falha. Uma recuperação vazia bem-sucedida custa um crédito e significa apenas que aquela consulta não retornou registros. Trate 400 como problema nos parâmetros, 401 como problema na chave, 402 como saldo insuficiente e 429 como limite de frequência, reduzindo tentativas repetidas sem critério.
Para apresentar uma conversa, agrupe localmente os registros quando houver parent_id e link_id, mas deixe visíveis os vínculos ausentes. O servidor retorna registros planos e não entrega uma árvore completa. Se dividir consultas por períodos, documente a estratégia e trate possíveis duplicatas na aplicação; a divisão não prova que todos os registros foram recuperados.
Teste o fim da paginação, datas invertidas, totais desconhecidos e interrupções de conexão antes de liberar o recurso. Considere no orçamento cada recuperação bem-sucedida, inclusive repetida ou vazia. Guarde os critérios e a data de execução para explicar a amostra obtida, sem transformar essa documentação em garantia de resultados idênticos ou disponibilidade futura.
