Defina o significado de Salvar
Neste aplicativo proposto, Salvar mantém uma referência histórica escolhida no dispositivo atual para leitura posterior. É uma funcionalidade a implementar no seu aplicativo, não um endpoint do arquivo. Reddit App API não oferece favoritos, sincronização entre dispositivos ou conta de lista salva. Explique a diferença antes de alguém depender dela em viagem.
Quando alguém salva uma conversa, o aplicativo deve guardar uma referência mínima em vez de duplicar todo o texto. Quando disponíveis, preserve identificador, link validado e contexto suficiente para reconhecer a escolha. Se também guardar um trecho curto selecionado pelo usuário, explicite a decisão e considere o conteúdo e os direitos de terceiros.
Não transforme três datas em uma
O aplicativo deve distinguir a criação original do momento em que o usuário salvou o item. Também pode anotar quando consultou o conteúdo escolhido. Um rótulo como Salvo neste dispositivo descreve uma ação local; não significa que a conversa foi escrita, verificada ou atualizada naquela data. Deixe desconhecida uma data original ausente.
Não trate título ou trecho salvo como prova de que a fonte ainda diga a mesma coisa. Preserve o contexto da seleção sem inventar detalhes. Um comentário salvo de um resultado parcial continua sendo referência àquele registro, não uma conversa completa ou garantia de que todas as respostas ao redor estarão disponíveis depois.
Separe leitura local de nova consulta
A lista pode mostrar metadados ou trechos já guardados sem chamar o serviço novamente. Faça a nova consulta ser deliberada em vez de atualizar todos os itens ao abrir a lista. Cada recuperação bem-sucedida custa um crédito, e consultar /v1/item?id=RECORD_ID também é uma solicitação. A chave continua no backend.
Uma consulta de item pode retornar data vazio com sucesso quando não há registro retornado; não suponha que o serviço use 404 ou 410 para um item salvo ausente. Esse vazio bem-sucedido é cobrado. Uma falha ou resposta perdida também não prova exclusão. Use rótulos diferentes para indisponível nesta consulta, solicitação falhou e não verificado novamente.
Ofereça controles locais coerentes
Ofereça uma ação clara Remover deste dispositivo. Ela deve apagar a referência local e o trecho associado conforme o desenho do aplicativo. Não exclui publicação do Reddit, remove registro do arquivo, fecha a conta do serviço nem muda seus pagamentos. Não apresente um controle local como pedido de exclusão mais amplo.
Se escolher limite de armazenamento ou validade, explique e teste essa regra do aplicativo em vez de inventar um prazo de retenção do serviço. Permita entender o que será descartado. Limpeza do dispositivo, restrições do navegador ou exclusão de dados do aplicativo também podem remover conteúdo local. Não prometa permanência só porque um item foi salvo.
Mantenha explícitas as expectativas offline
Uma lista apenas de referências pode precisar de conexão para abrir a fonte. Um trecho pode ser lido localmente se seu aplicativo o implementar e preservar, mas isso não torna uma conversa completa ou mapa disponível offline. Mostre o que realmente foi armazenado antes de a pessoa perder conectividade. O guia não afirma que tal função foi construída ou testada.
Separe esse armazenamento da sessão de conta do serviço e da referência de última fatura. O widget pode guardar id de fatura e usuário por host; não é uma lista de leitura nem deve guardar a chave API. Backup, exportação ou sincronização seriam funcionalidades adicionais a projetar e explicar. Volte a /pt/#field-notes para cartões e orçamento.
