Classifique a resposta antes de repetir
Este serviço é um arquivo histórico independente e não a API oficial do Reddit. Não oferece Reddit OAuth, publicação, votos ou mensagens privadas. O acesso é restrito à leitura dos dados disponíveis, sem a dinâmica em tempo real da plataforma. Repetir uma leitura não altera conteúdo no Reddit, mas pode consumir outro crédito e não garante resultados idênticos. Separe sucesso remoto, recepção no cliente e transformação local dos registros.
Comece com https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3, o exemplo da página inicial. subreddit escolhe devops e limit pede no máximo três comentários. Use X-API-Key: <chave> ou Authorization: Bearer <chave> no servidor; ambos os cabeçalhos são aceitos. Não envie um token Reddit OAuth. Confira o estado HTTP antes de interpretar o corpo como dados e grave a resposta recebida antes de avançar seu controle local.
Com HTTP 400, revise os parâmetros em vez de repetir indefinidamente a mesma solicitação inválida. As buscas de conteúdo aceitam q, subreddit, author, kind, from, to, min_score, limit e page; kind usa post ou comment. from/to seguem YYYY-MM-DD em UTC e filtram created_utc, incluindo o dia final inteiro. /v1/item exige id e /v1/subreddits aceita apenas prefix e limit. Consulte a documentação antes de transferir filtros entre rotas.
Corrija credenciais e saldo antes da próxima consulta
HTTP 401 significa chave ausente ou inválida. Confira domínio, nome do cabeçalho e segredo configurado sem imprimi-lo nos registros. Uma resposta vazia bem-sucedida não indica problema de chave. Para regenerá-la, entre no painel da página Obter chave API e confirme a senha; a anterior fica inválida imediatamente. Atualize os clientes que a utilizavam. Não há redefinição de senha nem envio de chave por e-mail.
HTTP 402 indica saldo insuficiente. Suspenda os trabalhos que exigem créditos e consulte o painel da conta; o status público não mostra saldo. Para comprar, entre e crie uma fatura antes de transferir o valor exato pela rede indicada. Depois envie o hash da transação para verificação. Aguarde o saldo creditado sem presumir prazo: pagar ou enviar um hash não demonstra, por si só, que a próxima recuperação esteja autorizada.
HTTP 429 indica limite de frequência. Você pode definir um número máximo de novas tentativas com pausas crescentes e encerrar o trabalho quando o orçamento de tentativas acabar. É uma escolha do cliente, sem garantia de recuperação posterior. Evite que cada camada do aplicativo crie uma segunda sequência automática de repetições. Os controles de elegibilidade do crédito de teste são aplicados na rede e não descrevem uma categoria de pagamento ou mecanismo de prioridade.
Separe custos, transporte e processamento dos dados
Uma recuperação bem-sucedida custa um crédito, mesmo vazia. Pedidos inválidos não descontam saldo; falhas do serviço de origem devolvem a reserva. Uma desconexão ou tempo de espera esgotado no cliente pode acontecer após um sucesso cobrado. Outra tentativa bem-sucedida custa outro crédito. Também não há devolução automática porque seu banco de dados falhou depois de receber uma resposta válida. Consulte os preços para incluir testes e repetições no orçamento.
Não use /v1/status como prova de saúde da busca ou validade da chave. Ele é público, gratuito e estático, e confirma apenas a resposta HTTP. Nas páginas de conteúdo, limit e page vão de 1 a 100; min_score filtra sem ordenar e _doc não representa tempo, relevância ou pontuação. eq indica total exato da consulta, gte um limite inferior e unknown um total não confiável, possivelmente null. Nenhum deles certifica cobertura completa.
Valide data e os campos necessários ao aplicativo. Os registros são planos; parent_id ou link_id presentes permitem associações locais sem conversa completa garantida. Grave os dados antes de marcar a página como concluída. Não suponha que repetir preenche referências ausentes, mantém a mesma ordem ou recupera tudo o que falta. Dividir períodos ou remover duplicatas localmente organiza o trabalho, mas não comprova um download exaustivo do arquivo.
