> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Ranking2 API 레퍼런스

랭킹 기능




스코어나 클리어 타임의 랭킹 처리를 구현합니다.

GS2-Ranking2는 글로벌 랭킹, 클러스터 랭킹, 구독 랭킹의 세 종류를 제공합니다.

- 글로벌 랭킹은 점수를 즉시 반영하고 상위 1,000명만 랭킹으로 보관하며, 그보다 낮은 플레이어는 순위권 밖으로 처리합니다.
- 클러스터 랭킹은 길드 ID와 같은 클러스터 ID마다 별도의 랭킹을 만듭니다. 점수를 등록할 때 플레이어가 대상 클러스터에 소속되어 있는지 검증할 수도 있습니다.
- 구독 랭킹은 플레이어가 구독한 다른 플레이어의 점수로 개인별 랭킹을 구성하여 친구 랭킹과 같은 비대칭 관계에 이용할 수 있습니다. 점수는 비동기로 반영되며 일반적으로 1초 이내에 갱신됩니다.

랭킹에는 GS2-Schedule 이벤트를 시즌으로 연결할 수 있습니다.<br>
이벤트 반복마다 새 시즌을 시작하고 과거 결과를 보관하며 순위 임계값에 따른 보상을 설정할 수 있습니다.

[마이크로서비스 소개 / GS2-Ranking2](../../microservices/ranking2)

**Tip**

GS2-Ranking2는 이름 그대로 버전 2에 해당하는 마이크로서비스입니다.

이전 버전에 관한 문서는 [GS2-Ranking]()를 참조해 주세요.




- [GS2-Ranking2 Deploy/CDK 레퍼런스](/ko/api_reference/ranking2/deploy/)
  
- [GS2-Ranking2 SDK API 레퍼런스](/ko/api_reference/ranking2/sdk/)
  
- [GS2-Ranking2 SDK for Game Engine API 레퍼런스](/ko/api_reference/ranking2/game_engine/)
  
- [GS2-Ranking2 마스터 데이터 레퍼런스](/ko/api_reference/ranking2/master_data/)
  
- [GS2-Ranking2 트랜잭션 액션](/ko/api_reference/ranking2/stamp_sheet/)