사용자와 작업, 결제 계정을 구분하세요
제품 사용자와 내부 작업, 조회 비용을 내는 도메인 계정은 서로 다른 대상입니다. 백엔드가 사용자와 작업을 연결하고 실행 권한을 검사합니다. 브라우저에는 허용된 결과를 돌려주세요. 공통 조회 키까지 전달하면 그 값을 가진 사람이 제품 화면에 정한 한도를 거치지 않고 유료 조회를 시작할 수 있습니다. 작업을 요청할 권한이 곧 원본 키를 받을 권한은 아닙니다.
개발 환경과 프로덕션 환경에서 API 키를 관리할 때는 환경 변수를 적극 활용해야 합니다. 키를 코드 파일에 직접 입력하면 버전 관리 시스템에 의해 의도치 않게 공개될 수 있습니다. 환경 변수를 사용하면 키의 변경이나 갱신이 소스 코드 변경 없이 이루어질 수 있어 유지보수성이 크게 향상됩니다. 다만 환경 변수가 빌드 과정에서 브라우저 파일에 삽입되지 않는지 확인하세요. 설정 전체를 출력하는 로그와 오류 보고서도 비밀 값을 노출할 수 있습니다. 인증 헤더는 기록에서 제거하고 경로, 필터, 상태 코드와 로컬 작업 식별자로 문제를 추적하는 편이 좋습니다.
허용된 아카이브 요청만 구성하세요
첫 작업에서는 아카이브 호스트와 허용할 검색 경로를 고정하세요. 검증한 입력으로 q=onboarding, subreddit=SaaS, limit=3을 구성한 후 외부 요청을 보낼 때만 키를 추가합니다. 방문자가 지정한 임의의 URL에 인증 헤더를 붙여 전달하지 마세요. 작업 실행 권한은 이 단계에 도달하기 전에 확인해야 하며, 허용하지 않은 동작은 요청을 보내기 전에 차단하도록 설계합니다.
Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 모두 유효한 조회 헤더입니다. 둘 다 Reddit OAuth 토큰이 아닌 이 도메인의 아카이브 키를 사용합니다. 다른 브랜드와 키나 잔액을 공유하는 것도 아닙니다. 공개 샘플, 화면 캡처와 문제 보고서에는 자리표시자만 사용하세요. 사용자에게 일부 결과를 볼 권한이 있다고 해서 제품이 사용하는 공통 키를 전달해도 되는 것은 아닙니다. 브라우저의 네트워크 화면과 소스 코드에 포함된 비밀 값은 사용자가 확인할 수 있습니다.
재시도 판단보다 먼저 기록하세요
작업에 내부 식별자와 작은 시도 예산을 부여하세요. 인증 헤더를 제외하고 경로, 필터, 시도 번호와 결과를 기록합니다. 예를 들어 페이지 이동과 재시도를 합쳐 총 세 번만 허용할 수 있습니다. 이것은 직접 구현할 제품 규칙입니다. 아카이브가 사용자별 할당량이나 작업 장부를 제공한다는 뜻은 아니며, 로컬 기록을 서비스의 공식 잔액으로 취급해서도 안 됩니다.
판단하기 어려운 흐름을 살펴보세요. 첫 요청은 빈 결과로 성공해 한 크레딧을 쓰고, 두 번째는 응답을 잃었지만 이미 과금되었을 수 있으며, 성공한 재시도에는 한 크레딧이 더 듭니다. 응답이 없다는 이유로 무료 실패라고 기록하지 마세요. 상위 시스템 실패는 예약분을 반환하지만 로컬 파싱이나 저장 오류는 과금된 성공을 취소하지 않습니다. 재시도 역시 남은 작업 예산 안에서 결정하세요.
해석하기 전에 응답을 저장하세요
화면용으로 변환하기 전에 받은 응답을 저장하세요. 기록은 평평하며 필드가 없거나 parent_id와 link_id가 받지 못한 자료를 가리킬 수 있습니다. 묶어도 완전한 대화를 증명하지는 못합니다. 날짜는 UTC의 YYYY-MM-DD이며 to 날짜를 포함합니다. q는 title과 text를 대상으로 일치하는 필드 안에서 AND를 적용하고, min_score는 필터이며 _doc는 순위나 시간순이 아닙니다. 저장한 자료의 범위를 설명할 때도 이 차이를 유지하세요.
두 키가 함께 작동한다고 가정하지 마세요
새 작업 접수를 멈출 수 있도록 교체 절차를 준비하세요. 로그인과 비밀번호 확인 후 재생성하면 이전 키는 바로 무효가 됩니다. 조회를 보내는 프로세스를 갱신한 다음 재개해야 합니다. 새 키와 옛 키가 함께 유효한 기간에 기대지 마세요. 새 값을 전달할 때도 읽을 수 있는 사람을 제한하고 진단 출력에 포함되지 않는지 확인해야 합니다. 작업 재개는 새 설정이 반영된 뒤에 진행하세요.
로컬 제한은 자체 백엔드를 통과하는 요청만 제어합니다. 유출된 키의 직접 사용은 막지 못합니다. 조사할 때 자체 시도 기록을 계정 상황과 비교하되 요청량 증가만으로 유출을 단정하지 마세요. 키 교체는 이미 쓴 크레딧을 돌려주지도 않습니다. 비밀번호도 보관해야 합니다. 재설정이나 키 이메일 전송 기능이 없으므로 계정 접근과 조회 프로세스의 접근을 각각 관리해야 합니다.
작은 작업으로 전체 경로를 확인하세요
마지막으로 작은 작업을 실행하고 실제 결과를 확인하세요. 400이면 매개변수, 401이면 키, 402이면 잔액, 429이면 빈도를 살핍니다. 조회 한도는 요청당 100개 기록과 쿼리당 100페이지이며 전체 범위를 보장하지 않습니다. /v1/status는 정적인 서비스 범위를 설명할 뿐 아카이브 상태를 검사하지 않습니다. 표본을 저장하고 더 조회하지 않기로 한 이유를 남기는 것도 올바른 작업 완료 방식이 될 수 있습니다.
