코드보다 먼저 수용 기준을 쓰세요
오래된 dataengineering 게시물을 사용하는 작업을 고르세요. 필수 필드, 본문이 없을 때의 표시, 정렬 순서에 대한 의존성을 적습니다. 각 요구 사항을 직접 지원, 로컬 처리, 이전 대상 제외 중 하나로 판단합니다. 이렇게 하면 성공한 HTTP 응답을 특정 읽기의 증거로 평가할 수 있습니다. Reddit Proxy는 독립적인 과거 아카이브이며 공식 API나 현재 Reddit 상태를 제공하지 않으므로 전체 클라이언트의 호환성을 연결 성공만으로 결론 내리면 안 됩니다.
새 키로 한 페이지를 저장하세요
GET https://api.redditproxy.com/v1/posts?subreddit=dataengineering&limit=3 을 X-API-Key: <키> 또는 Authorization: Bearer <키>로 실행합니다. 둘 다 redditproxy.com 아카이브 키를 사용하며 Reddit OAuth 토큰은 사용하지 않습니다. 요청 조건과 응답을 저장해 나중에 로컬에서 다시 처리할 수 있게 하고 진단 파일에는 비밀 정보를 남기지 마세요. 최대 세 건을 요청했더라도 세 건이 반드시 존재하는 것은 아닙니다.
게시물 목록은 /v1/posts, 댓글 목록은 /v1/comments, 검색은 /v1/search, 식별자를 아는 단일 기록은 /v1/item?id=... 에 대응합니다. 이들은 서로 다른 작업입니다. 단일 기록 조회가 전체 대화를 자동으로 가져오지는 않습니다. 기존 클라이언트의 임의 URL이나 지원되지 않는 매개변수를 그대로 넘기는 방식으로 이전 범위를 확대하지 마세요. 각 작업에서 필요한 필드는 별도로 검토합니다.
없는 문맥을 만들지 않고 매핑하세요
응답 데이터는 플랫 레코드 형태로 제공되며, 서버에서 스레드 트리로 구성된 복잡한 구조를 반환하지 않습니다. 일부 항목에는 parent_id 및 link_id와 같은 필드가 포함되어 있을 수 있지만, 이는 참조 정보일 뿐이며 완전한 대화 구조나 계승 관계를 보장하지 않습니다. 클라이언트는 이를 통해 로컬에서 그룹화할 수 있지만, 하위 댓글과 상위 게시물의 관계가 항상 완벽하게 매칭되는 것은 아닙니다.
data 배열과 보고서에 필요한 필드를 먼저 검사합니다. 값 없음, 빈 문자열, 로컬 변환 실패, 성공한 빈 페이지를 별도로 처리하세요. 받은 응답을 보관하면 원본과 변환 결과를 비교할 수 있습니다. 더 많은 페이지를 요청하기 전에 같은 저장 자료로 보고서를 만들어 검토하세요. 로컬에서 생성한 기본값을 원래 기록에 있던 정보처럼 표시하지 않는지도 확인할 수 있습니다.
필터의 의미를 확인하며 옮기세요
q는 title과 text를 검색하며 검색어들을 일치하는 하나의 필드 안에서 AND로 결합합니다. 필요한 단어를 제목과 본문에 나누어 넣는 것만으로는 일치하지 않습니다. 임의 쿼리 언어가 아닙니다. from과 to는 UTC 기준 YYYY-MM-DD이며 to 날짜 전체를 포함합니다. min_score는 수치 하한 필터일 뿐입니다. 내부 문서 순서 _doc는 시간, 관련도나 점수 순서가 아니고 로컬 정렬도 이미 받은 기록만 재배열합니다.
페이지를 끝내는 조건을 바꾸세요
요청당 최대 100개 기록, 쿼리당 최대 100페이지이며 각 페이지는 별도로 요청합니다. total과 relation을 함께 읽으세요. eq는 정확한 쿼리 합계, gte는 하한, unknown은 신뢰할 수 없는 합계이며 null일 수도 있습니다. 알 수 없다는 것은 0이라는 뜻이 아닙니다. 한도에 도달하거나 날짜를 나누어도 전체 수집 또는 중복 없는 결과가 증명되지 않습니다. 실제 요청한 페이지와 중단 이유, 남은 범위 질문을 메모에 기록하세요.
실패 경로를 시험한 뒤 보고서를 연결하세요
HTTP 400이면 매개변수, 401이면 키, 402이면 잔액을 확인하고 429에서는 빈도를 낮춥니다. 성공한 조회는 비어 있어도 한 크레딧입니다. 잘못된 요청은 차감하지 않고 상위 소스 장애에는 예약분을 돌려줍니다. 그러나 클라이언트가 응답을 잃어도 서버에서는 과금된 성공이 발생했을 수 있습니다. 다음 성공한 요청에도 별도 크레딧이 듭니다. 변환만 시험할 때는 저장한 응답을 로컬에서 다시 처리하세요.
완성한 보고서를 처음의 수용 기준과 비교하세요. 로컬 검증은 미래 응답의 불변성을 보장하지 않습니다. 쓰기와 현재 상태를 요구하는 기능은 이 변환 계층 밖에 둡니다. /v1/status는 정적인 서비스 범위와 HTTP 응답만 보여 주며 상위 소스의 정상 여부를 검사하지 않습니다. 문서에서 규격을, 요금에서 예산을, 키 페이지에서 계정 관리를 확인하며 판단 근거를 남기세요.
