검색을 맡겨도 제품은 팀이 설계합니다
Reddit API Cloud는 독립적인 과거 Reddit 아카이브이며 Reddit의 공식 또는 제휴 서비스가 아닙니다. 실시간 데이터, OAuth, 게시, 투표와 메시지 기능은 없습니다. 작은 SaaS 팀이 이 아카이브를 조회하기 위해 자체 Elasticsearch 클러스터를 운영할 필요는 없습니다. 하지만 모든 애플리케이션 인프라가 관리된다는 뜻은 아닙니다. 사용자 세션, 제품 권한, 오류 처리, 로컬 저장과 결과 화면은 자체 애플리케이션의 작업입니다. 호스팅된 검색과 완성된 SaaS 제품을 구분하세요. 외부 서비스를 호출한다는 사실만으로 제품이 항상 이용 가능하거나 모든 기록이 있다는 보장이 생기지는 않습니다.
처음에는 사용자가 명시적으로 실행하는 동작에 검색을 연결하세요. 저장한 메모를 열 때마다 새로운 유료 요청을 보낼 필요는 없습니다. 조사 공간과 메모, 보관 규칙은 자체 애플리케이션의 일부입니다. 먼저 하나의 완전한 작업 흐름이 실제로 유용한지 확인한 뒤 범위를 넓히면 됩니다.
최대 세 건을 화면까지 전달해 보세요
시작 예제는 GET https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&limit=3 입니다. q는 검색어, subreddit은 커뮤니티, limit은 원하는 최대 건수입니다. 세 건이나 특정 의견의 존재는 보장되지 않습니다. 작은 요청으로 서버 경유 처리를 확인할 수 있습니다. Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 모두 유효하며 이 도메인의 아카이브 키를 사용합니다. Reddit OAuth 토큰은 아닙니다. 자리표시자는 서버에서 실제 값으로 바꾸고 브라우저 코드와 로그에는 비밀 값을 남기지 마세요. 이 요청 형식은 실제 결과의 예가 아니므로 반환된 기록으로만 내용을 판단해야 합니다.
설명만을 위한 합성 응답입니다: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. 실제 요청을 실행한 결과가 아니며 잔액도 가상입니다. 빈 성공 응답도 한 크레딧을 쓴다는 예시일 뿐, SideProject 아카이브의 실제 수록 상태를 보여 주지는 않습니다.
표시 전에 data와 존재하는 title 또는 text를 확인하고 내용을 텍스트로 다루세요. 레코드는 평평한 구조입니다. parent_id나 link_id가 있으면 선택적으로 로컬에서 묶을 수 있지만 전체 대화가 완성된다는 보장은 없습니다. 빠진 맥락은 읽는 사람도 알아볼 수 있게 남겨 두세요.
빈 화면에도 정확한 의미를 담으세요
빈 결과는 이번 요청이 레코드를 반환하지 않았다는 뜻입니다. 그 주제가 한 번도 논의되지 않았거나 SideProject 전체를 조사했다는 증거는 아닙니다. 조회 실패에는 다른 화면 상태가 필요합니다. 접근할 수 없는 데이터 원본을 성공한 검색의 결과 없음으로 표현하면 사용자가 잘못 판단할 수 있습니다.
첫 기록은 내부 문서 순서로 오며 시간, 관련도, 점수 순서가 아닙니다. 작은 미리보기는 연결 시험이지 중요한 의견의 순위가 아닙니다. 받은 원문과 동료의 해석을 분리해서 보관하세요. 완전한 범위, 지속적인 가용성, 다시 요청했을 때 동일한 기록은 약속되지 않습니다. 저장한 메모를 현재 Reddit 활동처럼 보이지 않게 하는 것도 제품의 역할입니다.
한 번의 동작에 쓸 예산을 정하세요
성공한 조회는 빈 결과도 요청당 한 크레딧입니다. 성공 요청 1,000건은 $1이며 최소 $50 충전은 유료 50,000크레딧입니다. 구독제가 아니고 유료 크레딧은 만료되지 않습니다. 시험용 100크레딧은 네트워크 전체의 남용 방지 자격 조건에 따릅니다. 계정과 키, 잔액은 도메인별입니다. 고객별 한도는 제품에서 직접 구현하며 한 화면이 여러 요청을 실행할 수 있으므로 클릭 수와 레코드 수는 과금 단위가 아닙니다. 패널의 Secure HttpOnly 세션 쿠키도 조회 헤더와 별도 인증입니다. 실제 호출 사용량을 제품 동작과 나누어 기록하세요.
서버가 성공한 뒤 클라이언트에서 응답을 잃어도 크레딧이 차감될 수 있습니다. 성공한 재시도에는 한 크레딧이 추가로 듭니다. 유효하지 않은 요청은 차감하지 않고 상위 시스템 실패는 예약분을 반환합니다. 키 페이지에서 접근을 준비하고 문서에서 매개변수를 확인한 다음, 가이드에 따라 기능을 시험하세요.