결과를 읽기 전에 관측 단위 정하기
검토할 수 있는 판단을 먼저 쓰세요. replication과 일치해 받은 r/science 기록 중 연구의 반복 검증을 다루는 것은 무엇인가요? 관측 단위는 한 기록으로 정하고 게시물, 댓글 또는 둘 다를 포함할지 미리 선택합니다. 검색은 후보 텍스트를 고르고 로컬 읽기는 의미를 분류합니다. 단어 일치가 과학적 결과의 재현 성공을 증명하지는 않습니다.
연구 질문, 기록 유형, 커뮤니티, 기간과 포함 규칙을 먼저 적으세요. Reddit API Labs는 독립적인 과거 아카이브이며 공식 Reddit이나 실시간 데이터가 아닙니다. OAuth, 쓰기, 투표와 메시지는 없습니다. 받은 기록은 모든 사용자의 무작위 표본이 아닙니다. 문서화한 방법도 데이터가 미래에 항상 같다는 뜻은 아닙니다. 같은 저장 데이터로 분석 코드를 다시 실행하는 것과 API에서 새로 조회하는 것은 별도 작업입니다. 프로토콜에서 검증할 작업을 명시하고 결론의 범위도 정하세요. 필요한 기록의 존재와 방법의 명확성도 서로 다른 문제입니다.
실제로 실행한 검색 조건 기록하기
GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3 은 시작 예제이며 세 건을 보장하지 않습니다. q는 검색어, subreddit은 커뮤니티, limit은 최대 건수입니다. replication 검색은 무작위 추출이 아닙니다. from과 to는 UTC의 YYYY-MM-DD이고 to는 하루 전체를 포함하며 kind는 post 또는 comment입니다. min_score는 최소 조건으로 품질, 중요성 검사나 정렬이 아닙니다. 낮은 점수를 제외하는 선택 효과를 설명하고 조건을 나중에 바꿨다면 다른 실험 단계로 남기세요. 결과를 본 뒤의 변경을 처음부터 정한 조건인 것처럼 설명하면 안 됩니다.
replication crisis를 시험할 때는 쿼리 변경 사항을 기록하세요. q는 title과 text에서 일치하는 필드 안에 and 조건을 적용합니다. 제목의 단어와 본문의 다른 단어를 단순히 합치는 방식이 아닙니다. 넓은 조건과 좁은 조건의 응답을 따로 보관하세요. 어느 표현도 반복 검증에 관한 모든 어휘를 포괄하지 않습니다.
Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용합니다. 두 형식 모두 유효하며 이 도메인의 아카이브 키이고 Reddit OAuth 토큰이 아닙니다. 비밀 값은 서버에 보관하고 프로토콜과 로그에서 제외하세요. /v1/posts는 게시물, /v1/comments는 댓글이고 id는 목록 필터가 아니며 /v1/item?id=...는 식별자를 아는 한 항목입니다. /v1/subreddits?prefix=...는 커뮤니티 탐색에 쓸 수 있지만 완전한 알파벳순 목록이나 정확한 전체 집계가 아닙니다. 조건은 실제 실행한 요청에서 기록하고 수신 응답에 연결하세요. 예제 결과를 실제 수집한 자료처럼 사용하지 않아야 합니다.
원문을 보존하며 의미 분류하기
로컬 분류표에 기록 식별자가 있으면 적고, 범주와 판단 이유를 함께 남기세요. 초기 범주는 연구 반복 검증, 생물학적 복제, 문맥 부족으로 나눌 수 있습니다. 이것은 연구자의 주석이며 API가 제공하는 분류 필드가 아닙니다. 애매한 사례를 억지로 확정하지 말고 검토 대상으로 보관하며 원문과 분석용으로 정리한 텍스트를 분리하세요.
원래 JSON, 요청 시각, 페이지, 상태 코드와 저장 결과를 자체 환경에 남길 수 있습니다. 직접 계산한 파일 해시는 보관 파일의 동일성 확인이며 서버 버전이나 불변성 인증이 아닙니다. 코드 버전, 의존성, 정제와 분류 규칙을 적고 무작위 분석 단계가 있다면 그 설정도 남깁니다. 로컬 입력 검토와 새로운 아카이브 검색은 다릅니다. 코드와 데이터를 저장해도 과학적 결론이나 모든 환경의 동일 출력이 자동 보장되지는 않습니다. 조회 후의 변환도 원본과 구분하세요. 공유 자료에는 비밀 키를 제거하고 사용에 적용되는 권리도 고려해야 합니다.
비교할 때 한 가지 조건만 바꾸기
처음에는 저장한 입력을 고정하고 분류 규칙만 바꾸세요. 어떤 판단이 왜 달라졌는지 기록합니다. 나중에 새로 조회하면 별도 실행 기록을 만드세요. 입력 자료와 규칙을 함께 바꾸면 범주별 건수 차이가 어느 한 변화 때문이라고만 설명할 수 없습니다.
응답은 중첩되지 않은 레코드이고 parent_id와 link_id로 관계를 묶는 것은 선택 사항입니다. 읽기와 집계에는 트리가 필요 없고 누락된 부모도 복원되지 않습니다. 문서 순서는 시간순, 관련도순과 점수순이 아닙니다. 요청당 100개와 쿼리당 100페이지가 한도입니다. eq는 정확한 총계, gte는 하한, unknown 또는 null은 신뢰할 총계를 알 수 없는 상태입니다. 정확한 수라도 전량 저장은 증명되지 않습니다. 기간 분할과 중복 제거도 완전하고 중복 없는 수집을 보장하지 않습니다. 페이지, 중단 이유와 결측 항목을 프로토콜에 기재하세요. 실제 받은 자료의 범위를 유지해야 합니다.
중단 이유와 미해결 사례 보고하기
마지막에 매개변수, 받은 페이지, 유지한 기록, 제외 이유와 미해결 의미를 정리하세요. 중단 이유와 건수 계산에 사용한 규칙 버전도 적습니다. 결론은 이 자료로 한정해야 합니다. 알 수 없는 총계, 부족한 문맥 또는 아카이브 누락이 커뮤니티에서 해당 주제를 논의하지 않았다는 증거는 아닙니다.
성공한 조회는 빈 결과도 한 크레딧이고 1,000건은 $1입니다. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패의 예약분은 반환됩니다. 서버 성공 후 응답 유실에서는 성공한 재시도가 추가 비용입니다. 400은 매개변수, 401은 키, 402는 잔액, 429는 빈도를 확인하고 시도를 제한하세요. /v1/status는 공개 비과금이어도 정적인 범위와 HTTP 응답만 알리며 검색, 기록, 키와 잔액은 검사하지 않습니다. 크레딧 반환은 데이터 일관성을 증명하지 않고 영구 보존이나 성능도 보장되지 않습니다. 자료 이용에는 법률과 제삼자의 권리도 고려해야 합니다.
