자체 애플리케이션의 허용 범위를 정하세요
아카이브 키를 서버에 보관한다고 애플리케이션으로 오는 모든 요청이 허가되는 것은 아닙니다. 누가 어떤 검색을 시작하고 어떤 결과 필드를 볼 수 있는지 먼저 정하세요. Reddit Gateway는 독립적인 과거 Reddit 아카이브이며 Reddit과 제휴하지 않습니다. 실시간 데이터, Reddit OAuth와 쓰기 작업도 제공하지 않습니다. 자체 사용자 세션과 권한 판단은 아카이브 요청 인증과 다른 책임입니다.
사용자가 보낸 URL을 그대로 전달하는 대신 허용한 q, subreddit과 날짜 조건으로 변환하세요. 자체 서비스 필요에 맞는 기록 수와 페이지 수를 정합니다. 이 제안은 API의 새로운 보안 기능이 아니라 애플리케이션 작업 범위를 명확히 하는 설계입니다. 특정 역할 체계, 기업용 권한 화면이나 자동 오용 방지 결과를 약속하지 않습니다. 키를 숨기는 것만으로 자체 경로의 무제한 사용이 방지된다고 가정하지 마세요.
실제 키를 서버 비밀 설정에 두고 Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY로 보내세요. URL, 브라우저 코드와 공개 로그에는 넣지 않습니다. 계정 패널의 Secure HttpOnly 쿠키는 계정 작업용이며 조회 키를 대신하지 않습니다. 재발급하면 이전 값이 즉시 무효가 되므로 그 값을 참조하는 작업도 확인해야 합니다. 새 키가 준비되었다는 사실만 아니라 자체 앱 설정이 갱신되었는지도 검토하세요.
공개 status와 실제 검색을 구분하세요
GET /v1/status는 키와 크레딧이 필요 없습니다. 고정 서비스 범위와 HTTP 응답만 보여 주고 아카이브, 검색 실행, 기록, 키나 잔액은 검사하지 않습니다. 화면에서 이를 아카이브 상태라고 표시하지 마세요. 아직 실행하지 않은 검색을 추측하거나 측정하지 않은 지연 시간과 가동률을 만드는 근거로 삼아서는 안 됩니다. 관찰한 응답과 별도로 검증할 작업을 구분해야 합니다.
실제 검색에는 https://api.redditgateway.com/v1/search?q=database&subreddit=backend&limit=3 예제를 쓸 수 있습니다. q는 텍스트 조건, subreddit은 커뮤니티, limit은 한 응답의 상한입니다. HTTP 상태와 실제 필드를 검사하세요. 빈 결과면 그 상태를 설명하고 빠진 내용을 추측으로 채우지 않습니다. 받은 텍스트를 로컬 검토 목록에 넘기는 것은 자체 처리이며 API가 자동 분석 결과를 제공했다는 뜻은 아닙니다.
필요하면 author, kind와 UTC 기준 YYYY-MM-DD 형식의 from 및 to로 조건을 좁히세요. to 날짜는 포함되고 min_score는 최소 점수 조건이지 정렬이 아닙니다. 응답은 평면 기록입니다. 읽거나 개수를 세는 데 대화 트리가 필요 없고 존재하는 parent_id나 link_id로 선택적 로컬 그룹화를 할 수 있습니다. 두 필드는 조회 필터가 아니며 빠진 부모나 댓글을 복원하지도 않습니다.
페이지, 오류와 비용을 함께 계획하세요
요청 한 번은 최대 100개 기록, 쿼리 하나는 최대 100페이지이며 페이지마다 따로 요청합니다. 결과는 아카이브 문서 순서이고 시간, 관련도나 점수 순서가 아닙니다. 합계의 eq는 정확한 수, gte는 하한, unknown이나 null은 신뢰할 수 있는 합계가 없는 상태입니다. 정확한 합계도 전체 저장의 증거는 아닙니다. 기간 분할은 전체 수집이나 중복 없는 결과를 보장하지 않습니다.
HTTP 400은 조건, 401은 키, 402는 잔액을 검사하고 429에서는 송신을 늦추세요. 잘못된 요청은 차감하지 않고 상위 소스 오류에는 예약분을 돌려줍니다. 그러나 연결이 끊기기 전에 서버에서 유료 성공이 발생할 수 있습니다. 성공한 조회는 빈 결과도 한 크레딧이고 성공한 재시도는 추가 비용입니다. 모든 오류를 같은 무제한 재시도 루프에 넣지 않아야 합니다.
자체 작업 식별자로 어떤 조건, 페이지와 응답을 저장했는지 비밀 정보를 밝히지 않고 기록하세요. 저장 상태와 재시도 판단을 함께 검토할 수 있지만 기록이 아카이브의 전체 범위나 영구 보관을 입증하지는 않습니다. 홈에는 시작 예제, 문서에는 기술 계약, 요금에는 비용, API 키 받기에는 계정 절차가 있습니다. 한 번의 성공이 자체 애플리케이션의 모든 접근 제어가 올바르다는 증거는 아닙니다.
