챌린지 외 랭킹 조회 | Notion

path

GET /api/v1/rankings/challenges

설명

방 밖 랭킹 — 챌린지(방)끼리 비교한다. 솔로는 솔로끼리, 그룹은 그룹끼리만.

진행 중인 챌린지만 노출 — 만료·삭제된 방은 하루 1회 갱신 때 함께 제거된다.
산식: 그룹 = 방 전체 성공 ÷ (성공+실패), 솔로 = 그 솔로 방 자체 성공률.
등재 조건: 그룹 누적 50회 이상 / 솔로 10회 이상. rankingVisible=false인 솔로 방은 제외.
갱신은 하루 1회, 03시 판정 배치가 끝난 뒤 — 실시간 아님(updatedAt 표기).
화면: 최상단 내 방 등수 고정 + 1위부터 스크롤. 등재 미달이면 내 영역에 "-".

방 안 랭킹과 비교 단위·등재 기준·갱신 주기가 다르다.

구분	방 안 랭킹	방 밖 랭킹 (본 문서)
비교 단위	같은 방의 참여자끼리	같은 모드의 방끼리
등재 기준	참여 10회 이상	그룹 50회 / 솔로 10회 이상
갱신	요청 시 실시간 집계	하루 1회 03시 배치 스냅샷
완료된 방	조회 가능 (최종 랭킹 열람)	제외 — 진행 중인 방만

Request Param

Request Body

바디 없음. 모드·페이징은 전부 query로 받는다.

{}

Response Body

200 OK — 그룹 모드, 내 방이 등재된 상태