경로와 인증 정보
조회 호스트는 https://api.redditapicloud.com 입니다. GET /v1/search는 일반 검색, /v1/posts는 게시물, /v1/comments는 댓글입니다. /v1/item?id=...는 식별자를 아는 한 항목이고 /v1/subreddits?prefix=...는 커뮤니티 이름 접두어 검색입니다. /v1/status는 정적인 범위를 공개합니다. 독립적인 과거 아카이브이며 공식 Reddit 서비스, 실시간 데이터, OAuth, 쓰기, 투표와 메시지 기능은 없습니다. 호출을 위한 자체 Elasticsearch 운영이 필요하지 않아도 제품 사용자 권한과 결과 화면은 애플리케이션이 관리합니다. 호스팅된 조회와 모든 제품 인프라의 운영 대행은 다른 범위입니다.
Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 모두 유효합니다. 이 도메인의 아카이브 키를 사용하며 Reddit OAuth 토큰을 넣지 않습니다. 실제 값은 서버에서 추가하고 공개 코드, 브라우저 패키지와 로그에서 제외하세요. 패널의 Secure HttpOnly 세션 쿠키는 별도입니다. 계정과 키, 잔액은 다른 브랜드에서 공유할 수 없습니다. https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&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도 응답 필드일 뿐 쿼리 매개변수는 아닙니다. 호스팅 검색이 임의의 Elasticsearch 쿼리 언어나 자체 서버 분석을 공개한다는 의미는 아닙니다. 제공된 필터와 애플리케이션의 허용 목록을 기준으로 요청하세요.
요청당 최대 100개 레코드와 쿼리당 최대 100페이지이며 각 페이지는 별도 호출입니다. 문서 순서는 시간순, 관련도순이나 점수순이 아닙니다. eq는 정확한 총계, gte는 하한, unknown 또는 null은 신뢰할 총계를 알 수 없는 상태입니다. 정확한 수도 전량 저장을 증명하지 않습니다. 평평한 기록의 관계 정리는 선택 사항이며 읽기와 집계에는 트리가 필요 없고 누락된 부모도 복원되지 않습니다. 날짜 분할이나 중복 제거로 완전성을 증명할 수 없고 커뮤니티 집계와 접두어 검색도 정확한 전체 재고나 완전한 목록이 아닙니다.
비용, 오류와 상태 확인
성공한 조회는 빈 결과도 한 크레딧이고 1,000건은 $1입니다. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패의 예약분은 반환됩니다. 클라이언트 시간 초과는 서버 실패의 증거가 아닙니다. 성공 후 응답이 유실되면 성공한 재시도는 추가 비용입니다. 읽기 전용이어도 같은 응답이나 무료 반복은 보장되지 않습니다. 로컬 저장과 API 결과를 나누세요. 저장된 응답을 다시 처리하는 일과 API를 새로 호출해 재조회하는 일은 별도 작업으로 제품 예산에 기록해야 합니다. 저장 실패만으로 서버의 조회까지 실패했다고 판단하면 안 됩니다.
400은 매개변수 수정, 401은 키 확인, 402는 잔액 확인, 429는 빈도 감소가 필요합니다. 시도 횟수와 중단 조건을 정하고 다른 계정으로 제한을 피하지 마세요. /v1/status는 공개 비과금이어도 정적인 범위와 HTTP 응답만 알리며 검색 저장소, 기록, 키와 잔액은 검사하지 않습니다. 제품에서 빈 성공과 일시적인 오류를 나누어 표시할 수 있지만 화면을 만들어도 서비스 보장은 추가되지 않습니다. 완전성, 불변성, 영구 보존과 성능은 보장되지 않으며 쿼리와 애플리케이션 처리 결과는 별도로 남겨야 합니다.
