가입과 키 재생성
계정은 이메일과 비밀번호로 만듭니다. 비밀번호 길이는 UTF-8 기준 12–72바이트이며 글자 수와 같지 않을 수 있습니다. 한국어처럼 여러 바이트를 사용하는 문자를 포함하면 인코딩된 길이를 확인하세요. Google 로그인이나 지갑 연결은 가입 방식이 아닙니다. API 키는 가입 직후 결제 전에 한 번 표시됩니다. 결제를 해야 키를 받을 수 있는 구조가 아니므로 먼저 안전한 보관 장소를 준비하고 표시된 키를 보관하세요.
이후 로그인한다고 원래 키가 다시 표시되는 것은 아닙니다. 로그인 상태에서 비밀번호를 확인하면 키를 재생성할 수 있지만 이전 키는 즉시 무효화됩니다. 실행 중인 클라이언트의 설정도 새 키로 바꿔야 합니다. 키를 이메일로 보내 주거나 비밀번호를 재설정하는 기능이 있다고 가정하지 마세요. 재생성 전에는 어떤 작업이 이전 키를 사용하는지 확인하고, 변경 후에는 작은 조회로 인증 설정을 점검하는 편이 좋습니다.
조회 인증과 계정 로그인 구분
조회에는 Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용할 수 있습니다. 두 형식 모두 유효하며 Bearer 값은 Reddit OAuth 토큰이 아닌 이 아카이브의 키입니다. 계정 패널의 로그인은 Secure HttpOnly 세션 쿠키를 사용하므로 조회 헤더와 역할이 다릅니다. YOUR_API_KEY는 예제용 자리표시자이며 실제 키를 공개 저장소, 분석 기록이나 화면 캡처에 넣지 마세요. 이 도메인에서 발급한 키를 이 도메인의 API 호스트에 사용해야 합니다.
호환성 점검에는 https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3 같은 제한된 GET 요청을 사용할 수 있습니다. 두 헤더를 각각 시험하면 성공 요청마다 크레딧이 사용됩니다. 401은 키 설정, 402는 잔액, 429는 호출 빈도를 확인할 신호입니다. /v1/status는 비과금 공개 경로이지만 키와 잔액을 검사하지 않습니다. 계정, 키와 크레딧은 도메인별로 구분되며 다른 브랜드의 로그인이나 잔액이 그대로 적용된다고 가정하면 안 됩니다.
시험 이용과 유료 충전
시험용 100크레딧은 네트워크 전체의 남용 방지 자격 조건에 따라 제공됩니다. 유료 크레딧은 성공 조회 1,000건당 $1이며 최소 충전 $50은 50,000크레딧입니다. 빈 결과도 성공이면 한 크레딧을 사용하고 유료 크레딧은 만료되지 않습니다. 충전은 로그인 후 청구서를 먼저 만드는 순서로 진행하세요. 지원 자산은 TRON TRC20의 USDT와 Ethereum 메인넷 ERC20의 USDC이며 현재 청구서의 수신 주소와 정확한 금액을 따라야 합니다.
이체 후 거래 해시를 입력하고 검증을 요청하세요. 확인된 실제 이체가 서버에서 검증되어야 잔액이 추가됩니다. 청구서는 한 시간 후 만료되며 외부 제공자 장애가 있으면 검증은 대기 상태로 남을 수 있습니다. 즉시 정산, 잘못 보낸 자산의 복구나 수동 입금을 약속하지 않습니다. 계정 패널은 복구용 사용자 식별자와 청구서 식별자를 호스트별 로컬 저장소에 남기지만 API 키, 비밀번호나 거래 해시는 그 저장소에 보관하지 않습니다.
