앱에서 저장이 뜻하는 바를 정하세요
제안하는 하이킹 앱에서 저장은 선택한 과거 자료의 참조를 현재 기기에 보관했다가 나중에 읽는다는 뜻입니다. 앱이 구현할 기능이지 아카이브 엔드포인트가 아닙니다. Reddit App API는 북마크, 기기 간 동기화, 저장 목록 계정을 제공하지 않습니다. 사용자가 여행 중 이 목록을 믿고 사용하기 전에 그 차이를 설명하세요.
사용자가 토론을 나중에 읽도록 저장할 때는 게시물 본문 전체를 복제하기보다 최소한의 출처 참조를 저장해야 합니다. 제공된다면 레코드 식별자, 검증된 출처 링크, 선택한 자료를 알아볼 충분한 맥락을 보관하세요. 사용자가 선택한 짧은 발췌문도 보관한다면 그 선택을 분명히 알리고 관련 콘텐츠와 제삼자의 권리를 고려하세요.
세 가지 날짜를 하나로 섞지 마세요
앱은 레코드의 원래 작성 시점과 사용자가 저장한 시점을 구별해야 합니다. 선택한 자료를 조회한 시점도 기록할 수 있습니다. 「이 기기에 저장됨」이라는 라벨은 앱 동작을 설명하며, 그날 토론이 작성되거나 확인되거나 새로 조회되었다는 뜻이 아닙니다. 원래 날짜가 없으면 알 수 없는 상태로 남기세요.
저장된 제목이나 발췌문을 지금도 원문에 같은 내용이 있다는 증거로 취급하지 마세요. 내용을 지어내지 않으면서 선택 당시의 맥락을 보존합니다. 일부 결과에서 저장한 댓글은 그 레코드의 참조일 뿐, 완전한 스레드나 주변 답글을 나중에 모두 볼 수 있다는 보장이 아닙니다.
로컬에서 열기와 새 조회를 구분하세요
기기 내 목록은 서비스에 다시 요청하지 않고 이미 보유한 메타데이터나 발췌문을 표시할 수 있습니다. 목록을 열 때마다 모든 항목을 조용히 새로고침하기보다 새로운 조회를 의도적인 동작으로 만드세요. 정상 조회는 1크레딧을 사용하며 명시적인 /v1/item?id=RECORD_ID 조회도 요청입니다. 아카이브 키는 계속 백엔드에 보관합니다.
항목 조회에서 레코드가 반환되지 않으면 정상적인 빈 data 배열이 올 수 있습니다. 저장한 레코드가 없을 때 서비스가 404나 410을 쓴다고 가정하지 마세요. 그 빈 정상 응답도 과금됩니다. 요청 실패나 응답 손실 역시 항목 삭제의 증거가 아닙니다. 「이번 조회에서 확인 불가」, 「요청 실패」, 「다시 확인하지 않음」을 서로 다른 라벨로 구분하세요.
약속한 범위에 맞는 기기 내 제어를 제공하세요
제안하는 목록에 명확한 「이 기기에서 삭제」 동작을 제공하세요. 앱 설계에 따라 기기에 저장한 참조와 관련 발췌문을 제거해야 합니다. Reddit 게시물이나 아카이브 레코드를 삭제하거나 서비스 계정을 닫거나 결제 기록을 바꾸는 동작은 아닙니다. 로컬 제어를 더 넓은 범위의 삭제 요청으로 표현하지 마세요.
저장 용량 제한이나 만료 규칙을 정한다면 서비스의 보관 기한을 지어내는 대신 앱 자체 규칙으로 설명하고 테스트하세요. 독자가 무엇이 버려질지 이해할 기회를 줍니다. 기기 정리, 브라우저 저장소 제한, 앱 데이터 삭제로도 로컬 자료가 없어질 수 있습니다. 저장했다는 이유만으로 영구 접근을 약속하지 마세요.
오프라인에서 기대할 수 있는 범위를 작고 분명하게 정하세요
참조만 저장한 목록은 출처를 열 때 연결이 필요할 수 있습니다. 앱이 발췌문 보관을 구현하고 유지한다면 로컬에서 읽을 수 있지만, 전체 토론이나 지도가 오프라인에서 제공되는 것은 아닙니다. 사용자가 연결 가능한 지역을 떠나기 전에 실제로 저장된 콘텐츠가 무엇인지 보여 주세요. 이 가이드는 그런 오프라인 기능이 구현되거나 테스트되었다고 주장하지 않습니다.
이 앱 저장소를 서비스 웹사이트의 계정 세션 및 최신 청구서 참조와 분리하세요. 위젯은 호스트별로 청구서 id와 사용자 id를 저장할 수 있지만, 그 기능은 읽기 목록이 아니며 API 키 저장에 재사용해서는 안 됩니다. 백업, 내보내기, 기기 간 동기화는 별도로 설계하고 고지할 추가 기능입니다. 레코드 변환과 요청 예산은 /ko/#field-notes에서 확인하세요.
