Defina o resultado esperado
Nesta receita, concluir uma execução significa processar um lote limitado de exemplos de r/automation e registrar o resultado. Não significa esgotar o arquivo. Faça primeiro um teste manual e só depois escolha uma frequência compatível com a capacidade da equipe de revisar a fila.
Crie um identificador local da execução, guarde os parâmetros e defina o destino dos itens selecionados. Essas informações pertencem à sua aplicação, não são novos parâmetros da API. Se um exemplo esperado não aparecer, o histórico ajudará a verificar o que foi solicitado. Um arquivo independente de dados históricos não comprova a atividade atual do Reddit.
Construa a consulta a partir da pergunta
Envie GET https://api.apireddit.cc/v1/search?q=workflow&subreddit=automation&limit=3 com a chave em Authorization: Bearer ou X-API-Key. O lote pequeno permite examinar os campos antes de ampliar o mapeamento. Use kind=post para publicações ou kind=comment para comentários quando precisar separar os tipos.
A busca q consulta title e text. Vários termos usam AND dentro de um campo correspondente; não presuma que uma palavra apenas no título e outra apenas no texto sejam suficientes. Os filtros from e to usam YYYY-MM-DD em UTC, incluindo o dia indicado em to. min_score exclui registros abaixo do limite, sem ordenar os demais por pontuação.
Preserve a origem ao criar itens locais
Leve os campos disponíveis id e kind para o item e trate title e text como conteúdo para leitura, não como comandos para a automação. Acrescente a justificativa de seleção, o status da revisão e o número da execução em campos locais separados. Confira se o identificador já existe antes de criar outro item.
As respostas são planas. Agrupe por parent_id ou link_id apenas quando esses campos existirem e forem úteis. Relações ausentes continuam desconhecidas: não há garantia de uma conversa completa. Para consultar novamente um registro específico, /v1/item exige seu id. Essa consulta adicional também entra no orçamento.
Registre o motivo da parada
Defina um limite local dentro das 100 páginas permitidas e solicite até 100 registros por página. Mantenha os filtros durante o percurso. A ordem documental do arquivo não é cronológica, por relevância nem por pontuação; o primeiro item não funciona como marcador confiável do conteúdo mais recente.
Leia o total junto com a relação: eq significa quantidade exata, gte indica limite inferior e unknown pode acompanhar um total null. Diferencie parada por lote vazio e parada pelo orçamento de páginas. Dividir períodos ajuda a organizar novas execuções, mas não comprova recuperação exaustiva nem ausência de duplicatas.
Trate a incerteza antes de tentar novamente
Corrija os parâmetros diante de 400, verifique a chave diante de 401 e o saldo diante de 402. Para 429, aplique uma espera e limite as tentativas. Uma recuperação bem-sucedida vazia custa um crédito. Falhas na origem devolvem a reserva; solicitações inválidas não debitam créditos.
Se o cliente perder a resposta, o servidor pode já ter concluído a solicitação e consumido um crédito. Uma nova tentativa bem-sucedida consome outro. Registre o resultado incerto e elimine duplicatas localmente. /v1/status não é cobrado e retorna uma descrição estática do serviço; não verifica a saúde da busca na origem. Confira os preços antes de aumentar a frequência da rotina.
