작업과 범위 정의
Reddit Data Stream은 독립적인 과거 아카이브이며 공식 Reddit이나 실시간 데이터가 아닙니다. 변경 피드, SSE, WebSocket, OAuth, 쓰기, 투표와 메시지는 없습니다. 스케줄러의 정기 GET은 그런 기능이나 갱신 일정의 증거가 아닙니다. 작업의 커뮤니티, 유형, 기간과 페이지 상한을 적으세요. 실행별 로컬 식별자는 시도한 요청을 추적하는 데 쓸 수 있지만 자체 제어 기록입니다. 서버의 고정 스냅샷이나 정확히 한 번의 전달 장치가 아닙니다. 결과는 최신 이벤트 감시가 아닌 제한된 과거 조회로 설명하고 전체 변경 이력을 제공한다고 말하지 않아야 합니다.
GET https://api.redditdatastream.com/v1/posts?subreddit=apacheairflow&limit=3&page=3 은 시작 예제이고 세 건을 보장하지 않습니다. 댓글에는 /v1/comments, 일반 검색에는 /v1/search를 쓸 수 있습니다. from과 to는 UTC의 YYYY-MM-DD이며 to는 하루 전체를 포함하고 kind는 post 또는 comment입니다. min_score는 최소 조건으로 정렬하지 않습니다. id는 목록 필터가 아니고 /v1/item?id=...는 식별자를 아는 한 항목입니다. 기간 분할은 작업을 정리하지만 마지막 기록의 날짜가 이전의 전량 수집이나 새 데이터의 안전한 경계를 증명하지 않습니다. 페이지 번호도 시간순 진행이 아닙니다. 날짜 조건의 포함 규칙도 작업 정의에 남기세요.
조회, 쓰기와 적재 확인
Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용합니다. 두 형식 모두 유효하고 이 도메인의 아카이브 키이며 Reddit OAuth 토큰이 아닙니다. 비밀 값은 서버에 두고 파일과 로그에서 제외하세요. 응답 뒤 각 레코드 객체를 JSON 인코더로 처리하고 한 줄에 객체 하나와 줄바꿈을 써 JSONL로 만들 수 있습니다. 본문 안 줄바꿈은 인코더에 맡기고 응답의 바깥 구조를 레코드로 쓰지 마세요. 변환은 자체 코드이며 서버의 JSONL 출력이 아닙니다. 결측값을 꾸며 내지 말고 원래 응답을 변환 자료와 분리해 보관할 수 있습니다.
각 시도의 조건, 페이지, 시각, HTTP 결과, 파일 쓰기와 적재를 따로 기록하세요. 응답 성공 뒤 쓰기가 실패했을 때 번호만 올리면 미저장 자료를 건너뛸 수 있습니다. 재요청 전에 로컬 파일을 확인하세요. 임시 파일 검사 후 적재하는 것은 클라이언트 설계이고 누락 없는 재개나 동일 응답 보장이 아닙니다. 평평한 기록의 읽기와 집계에는 트리가 필요 없고 관계 정리는 선택 사항이며 누락된 부모도 복원되지 않습니다. 번호는 영구 커서가 아니고 로컬 중복 제거도 전체 범위와 수집의 유일성을 증명하지 않습니다. 저장과 호출의 성공을 따로 판단해야 합니다.
한도, 오류와 예산에 따라 중단
요청당 100개 레코드와 쿼리당 100페이지가 한도입니다. 문서 순서는 시간순, 관련도순이나 점수순이 아닙니다. eq는 정확한 총계, gte는 하한, unknown 또는 null은 신뢰할 총계를 알 수 없는 상태입니다. 정확한 수라도 전량 저장을 증명하지 않습니다. 기간 분할, 페이지 반복과 중복 제거는 완전하고 중복 없는 수집을 보장하지 않습니다. 커뮤니티 탐색도 완전한 알파벳순 목록이나 정확한 전체 집계가 아닙니다. 작업 보고에 받은 페이지, 적재한 파일과 중단 이유를 적고 전체 아카이브 복제나 완전한 변경 이력으로 소개하지 마세요. 실제 받은 범위를 기준으로 결론을 설명해야 합니다.
성공한 조회는 빈 결과도 한 크레딧이고 1,000건은 $1입니다. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패의 예약분은 반환됩니다. 서버 성공 후 응답 유실에서는 성공한 재시도가 추가 비용입니다. 400은 매개변수, 401은 키, 402는 잔액, 429는 빈도를 확인하고 시도를 제한하세요. /v1/status는 공개 비과금이어도 정적인 범위와 HTTP 응답만 알리며 검색, 기록, 키와 잔액은 검사하지 않습니다. 영구 보존이나 성능은 보장되지 않습니다. 로컬 재처리와 재조회를 구분하고 자료를 이용할 때 법률과 제삼자의 권리도 고려해야 합니다.
