Defina o trabalho permitido por uma ação
Uma função que reúne referências sobre onboarding precisa de uma decisão anterior à busca: quanto trabalho no arquivo cada ação do usuário pode iniciar? Reddit API Gateway oferece a equipes de infraestrutura de produto acesso a um arquivo histórico independente do Reddit, sem vínculo oficial ou atualizações ao vivo. A amostra de SaaS ajuda a definir esse limite antes de liberar a função aos clientes.
Imagine uma tela que apresenta algumas menções históricas. Seu backend verifica as permissões e aceita uma tarefa limitada. As regras por usuário e os limites de gasto são implementados por você. A chave identifica a conta do domínio que paga as consultas; não define papéis no produto nem distribui seu saldo entre clientes.
Peça três registros e considere receber nenhum
O exemplo é GET https://api.redditapigateway.com/v1/search?q=onboarding&subreddit=SaaS&limit=3. q=onboarding faz busca textual, subreddit=SaaS restringe a comunidade e limit=3 pede no máximo três registros. Sem kind, podem aparecer publicações e comentários. A consulta não classifica automaticamente recomendações de integração de usuários nem garante material pertinente. Envie pelo servidor X-API-Key: <chave> ou Authorization: Bearer <chave>; ambos os cabeçalhos são aceitos e usam a chave do arquivo.
Trecho sintético, apenas demonstrativo e sem solicitação real: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. O saldo é fictício. A lista vazia ilustra um sucesso que consome um crédito, mesmo que o produto não conserve registro algum. Grave a resposta realmente recebida antes de transformar campos e avançar o controle local. Falhar na transformação ou gravação local não anula o sucesso remoto cobrado.
Conte tentativas junto com a tarefa
Para planejar, permita no máximo três tentativas de recuperação por tarefa. Três solicitações bem-sucedidas custam três créditos, $0.003, mesmo que nenhum registro sirva para exibição. Esse limite é uma política da aplicação. Inclua mudanças de página e repetições, em vez de contar apenas as linhas aprovadas para a tela.
Processar novamente uma resposta salva não exige outra consulta ao arquivo. Buscar uma amostra nova pode trazer material diferente e, se houver sucesso, custa mais um crédito. Quando atualizar a seleção iniciar trabalho pago, ofereça essa ação de forma explícita ao usuário, sem confundi-la com a simples abertura do resultado salvo.
Explique o alcance da seleção
As respostas são planas: publicações e comentários chegam como registros individuais, sem árvores de discussão montadas no servidor. parent_id ou link_id presentes permitem associações locais, sem conversa completa garantida. O arquivo não garante cobertura total, resultados imutáveis, esquema constante ou disponibilidade permanente. Mantenha esses limites junto à amostra recebida; terminar uma tarefa do produto não comprova que toda a história do Reddit foi recuperada.
Apresente o resultado como a amostra recebida. Uma página curta não demonstra que inexistem outras conversas sobre onboarding em SaaS. Agrupar registros localmente também não recompõe uma conversa completa. Guarde os parâmetros e o contexto da recuperação junto da seleção, para que outra pessoa da equipe entenda o que foi examinado.
Prepare a amostra para virar uma função
Use a documentação para escolher filtros e a página de preços para dimensionar o orçamento de chamadas. A página da chave prepara a conta e o saldo; o guia acompanha a credencial pela tarefa permitida e por sua substituição. Defina responsáveis por essas etapas antes de transformar a amostra em uma operação recorrente do produto.
Antes de liberar a função de onboarding para mais usuários, acompanhe separadamente os limites de tentativas por ação e o saldo que paga as consultas. Cada recuperação bem-sucedida consome um crédito, mesmo sem dados aproveitáveis, à tarifa de $1 por 1000 sucessos. A compra mínima de $50 adiciona 50000 créditos, sem assinatura nem vencimento dos créditos comprados. Um pedido inválido não desconta saldo e uma falha do serviço de origem devolve a reserva. Se apenas a resposta se perder no cliente, o sucesso já pode ter sido cobrado; uma repetição bem-sucedida custa novamente. Por isso, o controle da tarefa deve acompanhar chamadas, não apenas linhas exibidas.
