투명한 Reddit 프록시와 구분하기
Reddit API Proxy는 과거 Reddit 기록을 조회하는 독립적인 아카이브 게이트웨이입니다. 이름에 프록시가 들어가지만 공식 Reddit API에 요청을 그대로 전달하는 서비스는 아닙니다. 실시간 피드나 Reddit과의 제휴를 제공하지 않으며, Reddit의 접근 제한을 우회하는 수단으로 설명해서도 안 됩니다. 통합 담당자는 먼저 현재 사용 중인 클라이언트가 필요한 것이 과거 기록 조회인지 확인해야 합니다. 현재 활동을 추적하는 기능과 아카이브 검색은 서로 다른 요구 사항입니다.
조회 인증에는 Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용할 수 있습니다. 두 형식 모두 유효하며 한 요청에 하나의 형식을 선택해 확인하면 됩니다. 여기서 Bearer 값은 이 도메인에서 발급한 아카이브 키이지 Reddit OAuth 토큰이 아닙니다. 예제의 YOUR_API_KEY는 자리표시자입니다. 실제 키를 공개 문서, 화면 캡처, 저장소나 요청 기록에 남기지 말고 실행 환경에서 안전하게 전달하세요. 계정 패널의 로그인 쿠키는 조회용 헤더와 별개입니다.
호환성 확인은 https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3 에 보내는 GET 요청으로 범위를 좁힐 수 있습니다. subreddit은 devops로, limit은 3으로 유지하고 사용하는 인증 헤더만 확인하세요. 이 주소는 재현 가능한 요청 형식을 보여 주며 실제 응답 내용이나 세 개의 댓글이 반드시 존재함을 약속하지 않습니다. 두 헤더를 각각 시험하면 별도 요청 두 건이 됩니다. 각각 성공하면 결과가 비어 있어도 각 요청에 크레딧 하나가 사용됩니다.
응답 범위와 로컬 처리
읽기 전용이라는 말은 게시, 투표, 메시지 전송 기능이 없다는 뜻입니다. 같은 요청을 다시 보냈을 때 내용이 항상 동일하거나 재시도가 무료라는 뜻은 아닙니다. 클라이언트에서는 요청한 경로와 필터, 시각, 상태 코드, 저장 성공 여부를 구분해서 기록하는 편이 좋습니다. 인증 값은 기록에서 제거하세요. 응답을 받았다는 사실과 결과를 로컬 파일에 정상적으로 저장했다는 사실도 따로 확인해야 합니다.
API 응답은 서버에서 조립된 스레드 트리가 아닌 평평한 레코드 형태로 제공됩니다. parent_id와 link_id 필드가 존재하는 경우 클라이언트 측에서 이를 로컬 그룹화할 수 있지만, 이것이 완전한 대화 구조나 상위 기록과의 관계의 보장을 의미하지는 않습니다. 또한 min_score는 오직 필터링만 수행할 뿐 정렬 기준이 되지 않습니다. 단순한 읽기, 건수 집계나 분류를 위해 트리를 만들 필요는 없습니다. 관계 분석이 필요한 경우에만 선택적으로 묶으세요. 반환되지 않은 부모 기록이나 빠진 댓글은 로컬 그룹화로 복구되지 않습니다. 결과를 완전한 대화로 소개하지 말고 실제 받은 레코드의 범위를 설명하세요.
검색, 게시물, 댓글 조회는 요청당 최대 100개 레코드와 쿼리당 최대 100페이지라는 한도가 있습니다. 결과는 아카이브 문서 순서이며 시간순, 관련도순이나 점수순이 아닙니다. 페이지를 모두 순회하거나 날짜 구간을 나누어도 전체 아카이브의 누락 없는 수집이나 중복 없는 결과가 보장되지는 않습니다. 전체 건수의 eq는 정확한 수, gte는 하한, unknown 또는 null은 신뢰할 수 있는 총계를 알 수 없음을 나타냅니다.
비용과 오류를 함께 확인하기
성공한 조회 요청 한 건은 크레딧 하나를 사용합니다. 요금은 성공한 요청 1,000건당 $1이며 최소 충전 $50은 유료 크레딧 50,000개에 해당합니다. 구독제가 아니고 유료 크레딧은 만료되지 않습니다. 시험용 100크레딧은 네트워크 전체의 남용 방지 자격 조건에 따라 제공되므로 모든 가입자에게 보장되는 잔액으로 계산하지 마세요. 키와 계정, 잔액은 이 도메인에 속합니다.
400은 요청 매개변수, 401은 키의 누락이나 유효성, 402는 잔액, 429는 요청 빈도를 점검할 신호입니다. 이 네 상태를 같은 방식으로 반복 재시도하지 마세요. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패에 대한 예약 크레딧은 반환됩니다. 그러나 응답이 클라이언트에 도착하지 않았더라도 서버에서는 유료 조회가 성공했을 수 있습니다. 이후 성공한 재시도에는 다시 비용이 발생할 수 있습니다.
공개된 /v1/status는 키 없이 호출할 수 있고 과금되지 않지만 정적인 서비스 범위와 HTTP 응답 여부만 알려 줍니다. 검색 저장소, 아카이브 기록, 키의 유효성이나 잔액을 검사하지 않습니다. 먼저 문서에서 경로와 필터를 확인하고, 키 페이지에서 계정을 준비한 뒤 제한된 조회로 헤더를 점검하세요. 현재 요청의 성공 여부와 장기적인 가용성, 성능 또는 기록 보존에 관한 보장은 구분해야 합니다.
