경로와 인증
조회 호스트는 https://api.redditapilabs.com 입니다. GET /v1/search는 일반 검색, /v1/posts는 게시물, /v1/comments는 댓글입니다. /v1/item?id=...는 식별자를 아는 한 항목이고 /v1/subreddits?prefix=...는 커뮤니티 이름 접두어 검색입니다. /v1/status는 정적인 범위를 공개합니다. 독립적인 과거 아카이브이며 공식 Reddit 서비스가 아니고 실시간 데이터, OAuth, 쓰기, 투표와 메시지 기능도 없습니다. 출처의 한계를 프로토콜에 적으세요. 방법 문서화는 불변성, 영구 보존이나 표본의 대표성을 보장하지 않습니다. 연구가 요구하는 기록이 실제로 존재하는지는 받은 결과와 구분해서 확인해야 합니다.
Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 모두 유효합니다. 이 도메인의 아카이브 키를 사용하며 Reddit OAuth 토큰은 넣지 않습니다. 실제 값은 서버에서 추가하고 프로토콜에는 자리표시자를 유지하세요. 패널의 Secure HttpOnly 세션 쿠키는 별도입니다. 계정과 키, 잔액은 다른 브랜드와 공유할 수 없습니다. https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3 은 세 건의 보장이나 무작위 추출이 아닙니다. 조건과 실제 응답을 따로 기록하고 비밀 값을 공개 코드나 연구 파일에 포함하지 마세요. 방법 설명을 위해 실제 자격 증명을 공유할 필요는 없습니다.
필터와 기록 형식
검색, 게시물과 댓글의 필터는 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 결과와 파일 저장을 나누고 저장된 응답의 재처리와 새로운 조회를 구분하세요. 프로토콜에도 이 차이를 기록해 어느 단계의 성공이나 실패인지 알 수 있게 해야 합니다. 로컬 쓰기 실패를 서버 실패로 단정하면 안 됩니다.
400은 매개변수 수정, 401은 키 확인, 402는 잔액 확인, 429는 빈도 감소가 필요합니다. 시도 횟수와 중단 조건을 정하고 다른 계정으로 제한을 피하지 마세요. /v1/status는 공개 비과금이어도 정적인 범위와 HTTP 응답만 알리며 검색, 기록, 키와 잔액은 검사하지 않습니다. 원래 응답, 조건, 시각, 페이지, 로컬 파일 해시와 코드 버전을 자체 환경에 보관할 수 있습니다. 이는 API의 고정 버전이나 미래 동일 응답의 약속이 아니며 성능과 지속적인 이용 가능성도 보장하지 않습니다. 실제 받은 기록에 근거해 작업 상태를 설명하세요.
