경로와 인증
조회 호스트는 https://api.redditdatastream.com 입니다. GET /v1/search는 일반 검색, /v1/posts는 게시물, /v1/comments는 댓글입니다. /v1/item?id=...는 식별자를 아는 한 항목이고 /v1/subreddits?prefix=...는 커뮤니티 이름 접두어 검색입니다. /v1/status는 정적인 범위를 공개합니다. 독립적인 과거 아카이브이며 공식 Reddit 서비스가 아니고 실시간 스트림, 변경 피드, SSE, WebSocket, OAuth, 쓰기, 투표와 메시지도 없습니다. 클라이언트가 페이지를 요청하고 처리하며 완성된 JSONL이나 로컬 쓰기의 서버 검증은 제공되지 않습니다. 파일 생성과 적재 상태는 자체 작업에서 확인해야 합니다.
Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 모두 유효합니다. 이 도메인의 아카이브 키를 사용하고 Reddit OAuth 토큰은 넣지 않습니다. 실제 값은 서버에서 설정하고 파일과 로그에서 제외하세요. 패널의 Secure HttpOnly 세션 쿠키는 별도입니다. 계정과 키, 잔액은 다른 브랜드와 공유할 수 없습니다. https://api.redditdatastream.com/v1/posts?subreddit=apacheairflow&limit=3&page=3 은 세 번째 페이지의 요청이며 세 건의 보장이 아닙니다. page는 영구 커서나 시간 경계가 아니고 번호를 저장해도 누락 없는 재개나 동일 스냅샷은 보장되지 않습니다. 요청 형식과 실제 받은 응답을 구분해서 기록하세요.
필터, 순서와 범위
검색, 게시물과 댓글의 필터는 q, subreddit, author, kind, from, to, min_score, limit, page입니다. kind는 post 또는 comment입니다. 날짜는 UTC의 YYYY-MM-DD이고 to는 지정일 전체를 포함합니다. min_score는 최소 점수 조건으로 정렬이나 품질 검사가 아닙니다. id는 /v1/item 전용이며 게시물과 댓글 목록의 식별자 필터는 아닙니다. parent_id와 link_id도 응답의 관계 항목이지 쿼리 매개변수가 아닙니다. 날짜 분할은 계획 수단이고 마지막 기록의 날짜가 이전 기간의 전량 수집이나 새 자료의 안전한 경계를 입증하지는 않습니다. 지원되지 않는 시각 정밀도를 가정해서도 안 됩니다.
요청당 최대 100개 레코드와 쿼리당 최대 100페이지이며 각 페이지는 별도 호출입니다. 문서 순서는 시간순, 관련도순이나 점수순이 아닙니다. eq는 정확한 총계, gte는 하한, unknown 또는 null은 신뢰할 총계를 알 수 없는 상태입니다. 정확한 수라도 전량 저장을 증명하지 않습니다. 관계 정리는 선택 사항이며 읽기와 집계에는 트리가 필요 없고 누락된 부모도 복원되지 않습니다. 페이지 반복과 중복 제거로 완전성이나 수집의 유일성을 증명할 수 없고 커뮤니티 집계도 정확한 전체 재고로 보장되지 않습니다. 접두어 검색도 완전한 알파벳순 목록이 아닙니다.
오류, 비용과 파일 상태
성공한 조회는 빈 결과도 한 크레딧이고 1,000건은 $1입니다. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패의 예약분은 반환됩니다. 클라이언트의 시간 초과가 서버 실패의 증거는 아닙니다. 응답이 유실된 경우 성공한 재시도는 추가 비용입니다. 읽기 전용이어도 같은 응답이나 무료 반복은 보장되지 않습니다. API 결과, JSONL 쓰기와 적재 대상의 반영을 구분하고 저장된 응답의 재처리는 새 호출과 나누세요. 로컬 진행 기록이 고정 스냅샷이나 정확히 한 번의 전달을 서버가 제공한다는 증거는 아닙니다. 각 단계의 결과를 실제로 검사해야 합니다.
400은 매개변수 수정, 401은 키 확인, 402는 잔액 확인, 429는 빈도 감소가 필요합니다. 시도 횟수와 중단 조건을 정하고 다른 계정으로 제한을 피하지 마세요. /v1/status는 공개 비과금이어도 정적인 범위와 HTTP 응답만 알리며 검색, 기록, 키와 잔액은 검사하지 않습니다. 작업의 각 단계에서 실제 성공 여부를 확인하세요. 완전성, 영구 보존, 불변성, 일정한 성능과 지속적인 가용성은 보장되지 않습니다. 정기 요청은 실시간 변경 기록이나 갱신 빈도의 증거도 아닙니다. 인증 비밀 값을 제외하고 조건과 중단 이유를 기록해야 합니다.
